home *** CD-ROM | disk | FTP | other *** search
/ Dr. Windows 3 / dr win3.zip / dr win3 / NEW_TECH / 4DOS4D.ZIP / 4DOS.DOC next >
Text File  |  1993-03-30  |  1MB  |  22,160 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                             44
  9.                            44
  10.                           44      DDDDDDD        OOOOO        SSSSSS
  11.                          44       DDDDDDDD      OOOOOOO      SSSSSSSS
  12.                         44  44    DD     DD    OO     OO    SS
  13.                        44   44    DD     DD    OO     OO    SS
  14.                       44    44    DD     DD    OO     OO     SSSSSS
  15.                      444444444    DD     DD    OO     OO      SSSSSS
  16.                       44444444    DD     DD    OO     OO           SS
  17.                             44    DD     DD    OO     OO           SS
  18.                             44    DDDDDDDD      OOOOOOO     SSSSSSSS
  19.                             44    DDDDDDD        OOOOO       SSSSSS
  20.  
  21.  
  22.  
  23.  
  24.                                        Version 4.02
  25.  
  26.  
  27.  
  28.  
  29.  
  30.                                        Developed By
  31.                                   Rex Conn and Tom Rawson
  32.  
  33.                                      Documentation By
  34.                          Hardin Brothers, Tom Rawson, and Rex Conn
  35.  
  36.  
  37.  
  38.                                        Published By
  39.  
  40.                                      JP Software Inc.
  41.                                        P.O. Box 1470
  42.                                  East Arlington, MA 02174
  43.                                             USA
  44.  
  45.                                       (617) 646-3975
  46.                                     fax (617) 646-0904
  47.  
  48.  
  49.  
  50.               Program Copyright 1988 - 1993, Rex C. Conn and JP Software
  51.               Inc., All Rights Reserved.  Documentation Copyright 1988 -
  52.               1993, JP Software Inc., All Rights Reserved.  4DOS is a
  53.               registered trademark and 4OS2 is a trademark of JP Software
  54.               Inc.  Other product and company names are trademarks of their
  55.               respective owners.
  56.  
  57.  
  58.  
  59.  
  60.                                     ACKNOWLEDGMENTS
  61.  
  62.  
  63.  
  64.  
  65.               We couldn't produce a product like 4DOS without the dedication
  66.               and quality work of many people.  Our thanks to:
  67.  
  68.                    JP Software Staff:  Mike Bessy, Helen Coyne, Ellen Stone,
  69.                    Marcella Turner, Misty White.
  70.  
  71.                    Beta Test Support:  David Moskowitz, Guy Scharf, Larry
  72.                    Finkelstein, and Martin Schiff, of CompuServe's CONSULT
  73.                    forum.
  74.  
  75.                    Online Support:  Brian Miller and Tess Heder of Channel 1
  76.                    BBS; Don Watkins of CompuServe's IBMNET.
  77.  
  78.                    Help System:  Scott McGrath and Ross Neilson Wentworth.
  79.  
  80.                    Beta Testers:  We can't list all of our beta testers
  81.                    here!  A special thanks to all of you who helped make
  82.                    4DOS elegant, reliable, and friendly.
  83.  
  84.  
  85.  
  86.               The following tools are used in creating and maintaining 4DOS
  87.               and the 4DOS Help System:
  88.  
  89.                  Compilers:        Microsoft C 6.0 and Macro Assembler 6.0,
  90.                                    Borland Turbo Pascal 5.5 and 6.0
  91.                  Libraries:        Turbo Professional (Turbo Power Software),
  92.                                    Spontaneous Assembly (Base Two
  93.                                    Development)
  94.                  Editors:          Edix (Emerging Technology), Brief
  95.                                    (Solution Systems)
  96.                  Debuggers:        Periscope (The Periscope Company), Soft-
  97.                                    ICE (Nu-Mega Technologies)
  98.                  Version Control:  PVCS (Sage Software)
  99.                  Documentation:    Microsoft Word for Windows with Adobe Type
  100.                                    Manager
  101.  
  102.                                                                      CONTENTS
  103.           ___________________________________________________________________
  104.  
  105.  
  106.  
  107.           CONTENTS
  108.  
  109.  
  110.           Introduction...............................................1
  111.                How to Use This Manual................................2
  112.                Registration and Upgrade Information..................5
  113.                Technical Support.....................................7
  114.  
  115.           Chapter 1 / 4DOS Features..................................9
  116.  
  117.           Chapter 2 / Installation..................................13
  118.                Automated Installation...............................13
  119.                Manual Installation..................................14
  120.                Uninstalling 4DOS....................................15
  121.  
  122.           Chapter 3 / A Guided Tour of 4DOS.........................18
  123.                Starting The Tour....................................18
  124.                Basic Commands.......................................20
  125.                Command Line Editing and History.....................24
  126.                More About Files.....................................27
  127.                Directory Navigation.................................31
  128.                Aliases..............................................33
  129.                Other Commands.......................................36
  130.                Batch Programming....................................38
  131.                Conclusion...........................................40
  132.  
  133.           Chapter 4 / General Concepts..............................41
  134.                DOS and the Command Interpreter......................41
  135.                     Primary and Secondary Shells....................42
  136.                     AUTOEXEC.BAT, 4START, and 4EXIT.................43
  137.                Command Processing...................................43
  138.                Files and Paths......................................45
  139.                The Environment......................................48
  140.                Memory...............................................49
  141.                ASCII and Key Codes..................................51
  142.                The Keyboard.........................................51
  143.                Video................................................52
  144.                ANSI Drivers.........................................53
  145.  
  146.           Chapter 5 / Using 4DOS....................................54
  147.                At the Command Line..................................54
  148.                     Command Line Editing............................55
  149.                     Command History and Recall......................56
  150.                     Command History Window..........................58
  151.                     Filename Completion.............................59
  152.                     Multiple Commands...............................61
  153.                     Automatic Directory Changes.....................61
  154.  
  155.  
  156.           ___________________________________________________________________
  157.           Copyright 1993, JP Software Inc.        4DOS Reference Manual  /  i
  158.  
  159.                                                                      CONTENTS
  160.           ___________________________________________________________________
  161.  
  162.  
  163.                     Temporarily Disabling Aliases...................62
  164.                     Command Line Help...............................63
  165.                Input and Output.....................................65
  166.                     Redirection.....................................66
  167.                     Piping..........................................67
  168.                     Keystack........................................68
  169.                File Processing......................................70
  170.                     Extended Parent Directory Names.................71
  171.                     Wildcards.......................................71
  172.                     Multiple Filenames..............................74
  173.                     Include Lists...................................74
  174.                     Executable Extensions...........................76
  175.                The Environment......................................78
  176.                     4DOS Configuration Variables....................80
  177.                     4DOS Internal Variables.........................81
  178.                     4DOS Variable Functions.........................85
  179.                Advanced Features....................................91
  180.                     Conditional Commands............................91
  181.                     Command Grouping................................92
  182.                     Escape Character................................94
  183.                     Argument Quoting................................95
  184.                Aliases..............................................96
  185.                Batch Files..........................................99
  186.                     .BAT Files and .BTM Files.......................99
  187.                     Echoing........................................100
  188.                     Batch File Variables...........................100
  189.                     Batch File Commands............................102
  190.                     Batch File Tips................................103
  191.  
  192.           Chapter 6 / Options and Tuning...........................109
  193.                Configuration Files.................................109
  194.                Setting up CONFIG.SYS...............................110
  195.                     4DOS and DOS 2.................................114
  196.                     Startup Options for Secondary Shells...........114
  197.                Using AUTOEXEC.BAT..................................115
  198.                Using 4START and 4EXIT..............................118
  199.                Using the 4DOS.INI File.............................119
  200.                     Types of Directives............................123
  201.                     Initialization Directives......................125
  202.                     Configuration Directives.......................129
  203.                     Color Directives...............................132
  204.                     Key Mapping Directives.........................133
  205.                     Advanced Directives............................138
  206.                     Examples.......................................141
  207.  
  208.           Chapter 7 / Using 4DOS with Your Hardware and Software...143
  209.                Hardware............................................143
  210.                     The CPU........................................143
  211.  
  212.  
  213.           ___________________________________________________________________
  214.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  ii
  215.  
  216.                                                                      CONTENTS
  217.           ___________________________________________________________________
  218.  
  219.  
  220.                     Memory.........................................144
  221.                     Video..........................................146
  222.                     Hard Drives and Floppy Disks...................148
  223.                     Laptop and Notebook Computers..................150
  224.                     Critical Errors................................151
  225.                Software............................................153
  226.                     4DOS and DOS...................................153
  227.                     Task Switchers and Multitaskers................154
  228.                     Multitasking and Disk Swapping.................155
  229.                     4DOS and Microsoft Windows 3.0.................156
  230.                     4DOS and DESQview..............................157
  231.                     Using 4DOS on a Network........................159
  232.                Solving Software Compatibility Problems.............161
  233.  
  234.           Chapter 8 / Command Reference Guide......................166
  235.                4DOS Commands.......................................166
  236.                How to Use the Command Descriptions.................168
  237.                ?...................................................172
  238.                ALIAS...............................................173
  239.                ATTRIB..............................................182
  240.                BEEP................................................184
  241.                BREAK...............................................185
  242.                CALL................................................186
  243.                CANCEL..............................................188
  244.                CD / CHDIR..........................................189
  245.                CDD.................................................191
  246.                CHCP................................................193
  247.                CLS.................................................194
  248.                COLOR...............................................196
  249.                COPY................................................197
  250.                CTTY................................................203
  251.                DATE................................................204
  252.                DEL / ERASE.........................................205
  253.                DELAY...............................................207
  254.                DESCRIBE............................................208
  255.                DIR.................................................210
  256.                DIRS................................................217
  257.                DRAWBOX.............................................218
  258.                DRAWHLINE...........................................220
  259.                DRAWVLINE...........................................221
  260.                ECHO................................................222
  261.                ECHOS...............................................224
  262.                ENDLOCAL............................................225
  263.                ESET................................................226
  264.                EXCEPT..............................................227
  265.                EXIT................................................229
  266.                FOR.................................................230
  267.                FREE................................................234
  268.  
  269.  
  270.           ___________________________________________________________________
  271.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  iii
  272.  
  273.                                                                      CONTENTS
  274.           ___________________________________________________________________
  275.  
  276.  
  277.                GLOBAL..............................................235
  278.                GOSUB...............................................237
  279.                GOTO................................................239
  280.                HELP................................................241
  281.                HISTORY.............................................243
  282.                IF..................................................245
  283.                IFF.................................................251
  284.                INKEY...............................................253
  285.                INPUT...............................................256
  286.                KEYSTACK............................................257
  287.                LH / LOADHIGH.......................................261
  288.                LIST................................................264
  289.                LOADBTM.............................................266
  290.                LOG.................................................268
  291.                MD / MKDIR..........................................270
  292.                MEMORY..............................................271
  293.                MOVE................................................272
  294.                PATH................................................276
  295.                PAUSE...............................................278
  296.                POPD................................................279
  297.                PROMPT..............................................280
  298.                PUSHD...............................................283
  299.                QUIT................................................285
  300.                RD / RMDIR..........................................286
  301.                REBOOT..............................................287
  302.                REM.................................................289
  303.                REN / RENAME........................................290
  304.                RETURN..............................................292
  305.                SCREEN..............................................293
  306.                SCRPUT..............................................294
  307.                SELECT..............................................296
  308.                SET.................................................302
  309.                SETDOS..............................................305
  310.                SETLOCAL............................................309
  311.                SHIFT...............................................310
  312.                SWAPPING............................................311
  313.                TEE.................................................312
  314.                TEXT................................................313
  315.                TIME................................................314
  316.                TIMER...............................................315
  317.                TRUENAME............................................317
  318.                TYPE................................................318
  319.                UNALIAS.............................................319
  320.                UNSET...............................................320
  321.                VER.................................................322
  322.                VERIFY..............................................323
  323.                VOL.................................................324
  324.                VSCRPUT.............................................325
  325.  
  326.  
  327.           ___________________________________________________________________
  328.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  iv
  329.  
  330.                                                                      CONTENTS
  331.           ___________________________________________________________________
  332.  
  333.  
  334.                Y...................................................326
  335.  
  336.           Appendix A / 4DOS Error Messages.........................327
  337.  
  338.           Appendix B / ASCII and Key Codes.........................338
  339.                ASCII...............................................338
  340.                Keys and Key Codes..................................342
  341.  
  342.           Appendix C / Technical Information.......................348
  343.                Detecting 4DOS......................................348
  344.                     Detecting 4DOS From a Batch File...............348
  345.                     Detecting 4DOS From a Program..................348
  346.                     Detecting the 4DOS Prompt......................349
  347.                Placing Keystrokes Into the Keystack................349
  348.                Writing Installable Commands........................350
  349.                Using DESCRIPT.ION..................................351
  350.                Interrupt 2E........................................353
  351.  
  352.           Glossary.................................................355
  353.  
  354.           Index....................................................367
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.           ___________________________________________________________________
  385.           Copyright 1993, JP Software Inc.        4DOS Reference Manual  /  v
  386.  
  387.                                                        CONTACTING JP SOFTWARE
  388.           ___________________________________________________________________
  389.  
  390.  
  391.  
  392.  
  393.           CONTACTING JP SOFTWARE
  394.  
  395.           You can contact JP Software at any of the following addresses.  Our
  396.           normal business hours are 9:00 AM to 5:00 PM weekdays, eastern US
  397.           time.  For more information about contacting us for technical
  398.           support see page 7.
  399.  
  400.  
  401.               By mail:
  402.  
  403.                    JP Software Inc.
  404.                    P.O. Box 1470
  405.                    East Arlington, MA 02174
  406.                    USA
  407.  
  408.  
  409.               By telephone:
  410.  
  411.                    Voice:          (617) 646-3975
  412.                    Fax:            (617) 646-0904
  413.                    Order Line:     (800) 368-8777 (orders only,
  414.                                    USA only)
  415.  
  416.  
  417.               Electronically:
  418.  
  419.                    CompuServe:     Customer Service 75020,244
  420.                                    Technical Support 75300,1215
  421.                    Bix:            "jpsoft"
  422.                    MCI Mail:       470-7811
  423.                    Internet:       Customer Service
  424.                                         75020.244@compuserve.com
  425.                                    Technical Support
  426.                                         75300.1215@compuserve.com
  427.                    BBS Support:    Via Channel 1 BBS, Boston,
  428.                                    617-354-7077 at 2400 baud, no
  429.                                    parity, 8 data bits, 1 stop bit
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.           ___________________________________________________________________
  442.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  vi
  443.  
  444.                                                                  INTRODUCTION
  445.           ___________________________________________________________________
  446.  
  447.  
  448.  
  449.           INTRODUCTION
  450.  
  451.  
  452.           Welcome, and thanks for purchasing 4DOS!
  453.  
  454.           We started developing 4DOS when we realized that our computers
  455.           could be a lot more powerful and a lot more helpful than they were.
  456.           Whether you are a computer novice or an experienced power user, we
  457.           think that 4DOS will help you get the most out of your IBM PC or
  458.           compatible computer.
  459.  
  460.           Technically, 4DOS is a command interpreter or "DOS Shell."  That
  461.           means that it reacts to the commands you type at the C> prompt.
  462.           We've designed 4DOS so that you don't have to change your computing
  463.           habits or unlearn anything to use it.  If you know how to display a
  464.           directory, copy a file, or start an application program, you
  465.           already know how to use 4DOS.  4DOS understands all of the commands
  466.           you know and adds to them.  Its purpose is to make DOS friendlier,
  467.           easier to use, and much more powerful and versatile, without
  468.           requiring you to use or learn a new program, a new set of commands,
  469.           or a new style of work.
  470.  
  471.           Once you have 4DOS installed, you can learn its new features at
  472.           your own pace.  It has more than 40 new commands and scores of
  473.           enhanced features, but you don't have to learn them all at once.
  474.           Relax, enjoy 4DOS's power, and browse through the manual
  475.           occasionally.  Press the F1 key whenever you need help.  4DOS will
  476.           soon become an essential part of your computer, and you'll wonder
  477.           how you ever got along without it.
  478.  
  479.           If you want to take 4DOS for a spin without performing a complete
  480.           installation, see the Guided Tour beginning on page 18.
  481.  
  482.           We are constantly working to improve 4DOS.  If you have suggestions
  483.           for features or commands that you think we should include in the
  484.           next version, or any other way we could improve our product, please
  485.           let us know.  Many of the improvements in this version of 4DOS were
  486.           suggested by our users, and while we can't promise to include every
  487.           suggested feature, we really do appreciate and pay attention to
  488.           your comments.
  489.  
  490.           If you're an OS/2 user, JP Software offers another product, 4OS2,
  491.           as a complete replacement for the OS/2 command processor (CMD.EXE).
  492.           4OS2 provides the same command set and syntax as 4DOS, with several
  493.           OS/2 commands added.  You can use it to maintain a common working
  494.           environment and run the same batch files under OS/2 and DOS.  4OS2
  495.  
  496.  
  497.  
  498.           ___________________________________________________________________
  499.           Copyright 1993, JP Software Inc.        4DOS Reference Manual  /  1
  500.  
  501.                                                                  INTRODUCTION
  502.           ___________________________________________________________________
  503.  
  504.  
  505.           is available at a discounted price for 4DOS users.  Contact JP
  506.           Software for more information.
  507.  
  508.  
  509.           How to Use This Manual
  510.  
  511.               We have designed this manual to serve as a gentle introduction
  512.               to 4DOS for novice users, as a tutorial for those who want to
  513.               get the most out of 4DOS, and as a reference manual for
  514.               advanced 4DOS users.
  515.  
  516.               You will likely find some parts of the manual too simple or
  517.               too technical for your tastes.  Unless you are convinced that
  518.               one of those sections holds just the information you need for
  519.               a specific task, feel free to skip to the next part of the
  520.               manual that is more to your liking.  You can use almost every
  521.               feature of 4DOS without having to worry about other features
  522.               or commands.
  523.  
  524.               As you read the manual, you will see the symbol ## next to
  525.               certain paragraphs.  This indicates a more in-depth discussion
  526.               or a more advanced topic which you can skip if you wish to
  527.               stick with the basics.  Come back to this topic later for more
  528.               details, or if you're having trouble with the particular issue
  529.               it discusses.  In many cases, the remainder of the section
  530.               you're reading after such a symbol will be devoted to similar
  531.               advanced information.  If you see the ## next to a section
  532.               heading, it means the entire section contains such
  533.               information.
  534.  
  535.               You may find the information in such marked sections useful
  536.               even if you're relatively new to computers or to 4DOS.
  537.               However you can skip the marked section and still understand
  538.               and use the basic topic of the section you're reading.
  539.  
  540.               An exclamation point [!] to the left of a paragraph means that
  541.               paragraph contains a caution or warning you may need to
  542.               observe when using the feature it discusses.
  543.  
  544.               This manual is divided into eight chapters and three
  545.               appendices, plus a glossary and index.  Here's a brief
  546.               overview of what you'll find in each:
  547.  
  548.               Chapter 1 / 4DOS Features
  549.  
  550.                    We begin with a short summary of some of 4DOS's features
  551.                    to give you a taste of what 4DOS is about.  Start here if
  552.                    you are new to 4DOS.
  553.  
  554.  
  555.           ___________________________________________________________________
  556.           Copyright 1993, JP Software Inc.        4DOS Reference Manual  /  2
  557.  
  558.                                                                  INTRODUCTION
  559.           ___________________________________________________________________
  560.  
  561.  
  562.               Chapter 2 / Installation
  563.  
  564.                    Everyone should read this short chapter.  The
  565.                    installation instructions are simple (and quite different
  566.                    from previous versions of 4DOS).
  567.  
  568.               Chapter 3 / A Guided Tour of 4DOS
  569.  
  570.                    This chapter will take you on a short, interactive tour
  571.                    of some of 4DOS's most powerful features.  By the time
  572.                    you finish the tour, you will have a good idea of what
  573.                    4DOS will do for you.  If you are new to 4DOS, be sure to
  574.                    take the tour.
  575.  
  576.               Chapter 4 / General Concepts
  577.  
  578.                    This reference chapter is an introduction to several
  579.                    terms and concepts that we use throughout the manual.  If
  580.                    you're a novice, you might want to browse through the
  581.                    entire chapter.  If you're a power user and all of the
  582.                    topics in this chapter seem simple, then go on to the
  583.                    next chapter.  If you think you need to brush up a bit on
  584.                    the basics of a couple of terms and ideas, you'll
  585.                    probably find them here.
  586.  
  587.               Chapter 5 / Using 4DOS
  588.  
  589.                    This chapter is for everyone.  It contains a description
  590.                    of 4DOS's features and lots of examples to help you learn
  591.                    to use each one.  Even if you are a novice user and want
  592.                    to ignore some of these features until later, skim
  593.                    through this chapter to get an idea of what is available
  594.                    and where to find the information that you will
  595.                    eventually want.  4DOS offers both features which are not
  596.                    related to specific commands, and a complete set of over
  597.                    80 internal commands.  This chapter has complete
  598.                    reference information on all of the non-command features,
  599.                    and introduces a few commands as well.  Reference
  600.                    information on 4DOS commands is in Chapter 8.
  601.  
  602.               Chapter 6 / Options and Tuning
  603.  
  604.                    This chapter is for advanced users who want to be sure
  605.                    that 4DOS is running at top efficiency on their systems.
  606.                    It includes detailed information on setting up 4DOS and
  607.                    on changing your 4DOS configuration.
  608.  
  609.  
  610.  
  611.  
  612.           ___________________________________________________________________
  613.           Copyright 1993, JP Software Inc.        4DOS Reference Manual  /  3
  614.  
  615.                                                                  INTRODUCTION
  616.           ___________________________________________________________________
  617.  
  618.  
  619.               Chapter 7 / Using 4DOS With Your Hardware and Software
  620.  
  621.                    This chapter contains tips on using 4DOS with many
  622.                    popular kinds of PC hardware and software, and
  623.                    information that will be useful if you think 4DOS may
  624.                    conflict with your hardware or other software.
  625.  
  626.               Chapter 8 / 4DOS Command Reference
  627.  
  628.                    4DOS knows over 80 internal commands.  This chapter
  629.                    explains the purpose of each command and tells you how to
  630.                    use it.  It has examples that will help you learn each
  631.                    command and the technical details you will need to get
  632.                    the command to behave exactly as you wish.
  633.  
  634.               Appendices
  635.  
  636.                    We've included some helpful tables here, and some
  637.                    information for those who like to know technical details.
  638.                    There are three appendices.
  639.  
  640.                    Appendix A lists all 4DOS error messages.  Look here if
  641.                    you need an explanation of an error message, or if you
  642.                    aren't sure if the message came from 4DOS.
  643.  
  644.                    Appendix B lists codes for the ASCII character set (your
  645.                    computer's internal method for representing letters,
  646.                    digits, and other characters) and for the keys on your
  647.                    keyboard.  These codes can be useful with certain 4DOS
  648.                    commands.
  649.  
  650.                    Appendix C covers technical information and programming
  651.                    interfaces.  You shouldn't need to use it unless you are
  652.                    an advanced user or a programmer writing add-on software
  653.                    for 4DOS.
  654.  
  655.               Glossary
  656.  
  657.                    If you need help with any of the terminology in this
  658.                    manual, look here.
  659.  
  660.               Index
  661.  
  662.                    If you can't find the information you need, this should
  663.                    help you find it.
  664.  
  665.  
  666.  
  667.  
  668.  
  669.           ___________________________________________________________________
  670.           Copyright 1993, JP Software Inc.        4DOS Reference Manual  /  4
  671.  
  672.                                                                  INTRODUCTION
  673.           ___________________________________________________________________
  674.  
  675.  
  676.               Quick Reference Card
  677.  
  678.                    If you can't remember a key combination, command format,
  679.                    color name, or other general information, look here.
  680.                    Whether you are a 4DOS novice or expert, you will
  681.                    probably want to keep the Quick Reference card near your
  682.                    computer for those times when you need just a small jog
  683.                    to your memory.
  684.  
  685.               Additional Files
  686.  
  687.                    Files distributed with 4DOS cover important additional
  688.                    information beyond what's included in this manual.
  689.                    README.DOC contains general notes, highlights of the
  690.                    latest release, and brief installation instructions for
  691.                    those upgrading from a downloaded copy of 4DOS.
  692.                    UPDATE.DOC covers any changes or corrections in the
  693.                    manual, and detailed information for users with older
  694.                    versions on what has changed in the latest release.
  695.                    APPNOTES.DOC contains application notes for a variety of
  696.                    other software packages to help you use those packages to
  697.                    best advantage with 4DOS.
  698.  
  699.  
  700.           Registration and Upgrade Information
  701.  
  702.               If you purchased 4DOS from a software dealer, your copy came
  703.               with a registration card.  Please fill out this card and
  704.               return it promptly to JP Software.  Returning the registration
  705.               card ensures that we have a record of your registration, and
  706.               enables you to receive ongoing technical support and notices
  707.               of upgrades.  If you purchased 4DOS directly from JP Software,
  708.               you are already registered and no registration card is
  709.               necessary.
  710.  
  711.               Once you are a registered 4DOS user, you will receive:
  712.  
  713.                    *  A subscription to The Prompt Solution, JP Software's
  714.                       publication for 4DOS users and other customers.  The
  715.                       Prompt Solution includes tips for using 4DOS,
  716.                       notification of upgrades, and information about 4DOS
  717.                       enhancements and other products from JP Software.
  718.  
  719.                    *  Technical support via electronic mail, fax, mail, or
  720.                       telephone.
  721.  
  722.                    *  A free or low-cost upgrade to the next version of 4DOS;
  723.                       see below for details.
  724.  
  725.  
  726.           ___________________________________________________________________
  727.           Copyright 1993, JP Software Inc.        4DOS Reference Manual  /  5
  728.  
  729.                                                                  INTRODUCTION
  730.           ___________________________________________________________________
  731.  
  732.  
  733.               4DOS is upgraded regularly through maintenance releases,
  734.               designed to fix minor problems or improve compatibility, and
  735.               major upgrades which contain enhancements and additional
  736.               features.  Maintenance releases are identified by a change in
  737.               the hundredths digit of the version number, for example from
  738.               4.0 to 4.01 or 4.02.  New versions are identified by a change
  739.               in the tenths digit or "ones" digit, for example from 4.0 to
  740.               4.1 or 5.0.
  741.  
  742.               As a registered user you will automatically be notified when a
  743.               major upgrade of 4DOS is released.  The first major upgrade
  744.               released after your initial purchase of 4DOS can be obtained
  745.               at no charge if you download it from one of our support areas
  746.               (see below).  A new manual will be available for download from
  747.               the same sources.  If you do not have a modem or prefer to
  748.               obtain the new version on diskette, there is a minimal
  749.               processing charge; there is also a charge for a new printed
  750.               manual.  After you've received this first free or low-cost
  751.               upgrade, there will be a standard upgrade charge to get
  752.               additional major upgrades as they are released.
  753.  
  754.               We don't send out notices when maintenance releases become
  755.               available, because you don't usually need them unless you're
  756.               having a problem.  However, you can download maintenance
  757.               releases from our support areas (see below), or order them on
  758.               disk at a nominal cost.  If you call with a problem that's
  759.               been addressed in a maintenance release, we'll mail you a copy
  760.               on disk or assist you in downloading it.  Downloading a
  761.               maintenance release or obtaining it on disk from JP Software
  762.               is separate from and does not affect your eligibility for a
  763.               free or low-cost upgrade to the next major upgrade of 4DOS.
  764.  
  765.               As a registered user, you can download maintenance releases
  766.               and your free or low-cost 4DOS upgrade from the JP Software
  767.               support area on CompuServe (GO PCVENB, library 10), Bix
  768.               (ibm.vendors/listings), or Channel 1 (see below).  The file
  769.               name(s) used for 4DOS updates vary from time to time depending
  770.               on the extent of the changes made, but typically will look
  771.               like 4DOS4*.ZIP.  The "*" refers to one or more characters
  772.               further identifying the file.  Check the directory listings
  773.               and file descriptions on the service you are using to identify
  774.               the files you need.  Downloads are also available from many
  775.               other local bulletin boards and online services.  Lists of
  776.               download locations, including bulletin boards outside the USA,
  777.               are published from time to time in The Prompt Solution and are
  778.               included in the SUPPORT.BBS file that comes with 4DOS.
  779.  
  780.  
  781.  
  782.  
  783.           ___________________________________________________________________
  784.           Copyright 1993, JP Software Inc.        4DOS Reference Manual  /  6
  785.  
  786.                                                                  INTRODUCTION
  787.           ___________________________________________________________________
  788.  
  789.  
  790.               We offer BBS support through Channel 1 in Boston, one of the
  791.               largest and best-run bulletin boards in the US.  Channel 1 is
  792.               an independent bulletin board and is not owned or operated by
  793.               JP Software.  To access Channel 1 set your modem to 2400 baud,
  794.               no parity, 8 data bits, and 1 stop bit, and dial 617-354-7077
  795.               (if you have a high-speed modem, additional numbers are
  796.               available once you are online).  Join conference 5 for 4DOS
  797.               downloads.  You can leave 4DOS support messages and download
  798.               4DOS files at no charge, but if you want to use any of Channel
  799.               1's other excellent services you may need to purchase a
  800.               membership to have sufficient online time.
  801.  
  802.  
  803.           Technical Support
  804.  
  805.               Technical support for 4DOS is available to all users.  When
  806.               you contact us for support please give us your 4DOS serial
  807.               number so that we can verify your status as a customer, keep
  808.               track of your inquiry properly, and contact you if necessary.
  809.  
  810.               Often the best way to contact us for support is by modem in
  811.               one of the following public 4DOS support conferences.  The
  812.               numbers in parentheses indicate the usual delay, in days, to
  813.               receive a reply to a message.
  814.  
  815.               CompuServe / ZiffNet:  Primary support is via the JP Software
  816.               section of the CompuServe PCVENB forum (GO PCVENB, section 10)
  817.               (1 day).  We monitor other CompuServe and ZiffNet forums, but
  818.               response may vary depending on our workload.
  819.  
  820.               Bulletin Boards:  Primary support is via the Channel 1 BBS,
  821.               Boston, MA (1 - 3 days; see above for access details).
  822.               Messages may be left in any of the 4DOS conferences; check the
  823.               online list for exact conference numbers, which may change.
  824.               Additional support is available from many local BBSes via the
  825.               4DOS conferences on the ILink, RIME (PC Relay), SmartNet, and
  826.               FidoNet BBS Networks (3-5 days).
  827.  
  828.               BIX:  Support is available via the ibm.vendors conference,
  829.               topic 4DOS (3-5 days).
  830.  
  831.               In addition, you can contact JP Software for support by mail,
  832.               telephone, fax, or electronic mail.  Addresses and phone
  833.               numbers are listed on page vi of this manual.
  834.  
  835.               Our goal is to return all telephone messages within 24 hours
  836.               (weekends and holidays excluded).  If your problem is urgent
  837.               and requires a faster response, please let us know and we will
  838.  
  839.  
  840.           ___________________________________________________________________
  841.           Copyright 1993, JP Software Inc.        4DOS Reference Manual  /  7
  842.  
  843.                                                                  INTRODUCTION
  844.           ___________________________________________________________________
  845.  
  846.  
  847.               try to accommodate you.  If you contact us by telephone and
  848.               don't receive a reply within 24 hours, please try again.  We
  849.               may have tried to return your call and been unable to reach
  850.               you.
  851.  
  852.               Before contacting us for support, please check if the manual
  853.               or other documentation answers your question.  If you can't
  854.               find what you need, try Chapter 4 / General Concepts (page
  855.               41), and the Index.  If you're having trouble getting 4DOS to
  856.               run properly, either alone or with your particular hardware or
  857.               software, see Chapter 7 / Using 4DOS with Your Hardware and
  858.               Software, on page 143, and the APPNOTES.DOC file on your 4DOS
  859.               disk.  Also look through the README.DOC and UPDATE.DOC files
  860.               that came with 4DOS, as they may contain updates to this
  861.               manual or other important information.
  862.  
  863.               If you do need to contact us for support, it helps if you can
  864.               give us some basic information:
  865.  
  866.                    *  What exactly did you do?  A concise description of what
  867.                       steps you must take to make the problem appear is much
  868.                       more useful than a long analysis of what might be
  869.                       happening.
  870.  
  871.                    *  What went wrong?  At what point did the failure occur?
  872.                       If you saw an error message or other important or
  873.                       unusual information on the screen, what exactly did it
  874.                       say?
  875.  
  876.                    *  Briefly, what techniques did you use to try to resolve
  877.                       the problem?  What results did you get?
  878.  
  879.                    *  What are the contents of your CONFIG.SYS, AUTOEXEC.BAT,
  880.                       4START, 4EXIT, and 4DOS.INI files, any batch files they
  881.                       call, and any alias or environment variable files they
  882.                       load?
  883.  
  884.                    *  Can you repeat the problem or does it occur randomly?
  885.                       If it's random, are there any clues as to what programs
  886.                       you're using when the problem occurs?
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.           ___________________________________________________________________
  898.           Copyright 1993, JP Software Inc.        4DOS Reference Manual  /  8
  899.  
  900.                                                     CHAPTER 1 / 4DOS FEATURES
  901.           ___________________________________________________________________
  902.  
  903.  
  904.  
  905.           CHAPTER 1 / 4DOS FEATURES
  906.  
  907.  
  908.           4DOS is a complete computing environment that works with all
  909.           versions of MS-DOS and PC-DOS from 2.0 to 5; with DR-DOS 3.4, 5.0,
  910.           and above; and in OS/2 DOS sessions.  It is compatible with
  911.           virtually all application programs, with Microsoft Windows, and
  912.           with task switching programs like DESQview and Back & Forth.
  913.  
  914.           4DOS replaces the traditional DOS user interface with a more
  915.           modern, friendlier, and more powerful one.  4DOS is completely
  916.           compatible with traditional DOS commands, and adds dozens of new
  917.           features that aren't available with any version of DOS.
  918.  
  919.  
  920.               Minimal Memory Usage
  921.  
  922.               4DOS can take advantage of extended memory, expanded memory,
  923.               and memory managers for 386, 486, and some 80286 and 8086/88
  924.               computers that let programs "load high."  If you load both
  925.               4DOS and the environment "high," 4DOS will use only 256 bytes
  926.               of base memory, less than any version of the traditional DOS
  927.               command processor, COMMAND.COM.  (See page 128.)
  928.  
  929.  
  930.               Online Help
  931.  
  932.               4DOS has complete, full-screen, context-sensitive help for all
  933.               of its commands and all DOS utilities.  The F1 key pops up the
  934.               help system at any time from the 4DOS prompt.  The help system
  935.               is cross-referenced and includes examples.  (See page 63.)
  936.  
  937.  
  938.               Directory Navigation
  939.  
  940.               4DOS's enhanced CD command lets you specify where to look for
  941.               subdirectories you're changing to.  CDD lets you switch drives
  942.               and directories simultaneously, and the new automatic
  943.               directory change feature changes directories for you when you
  944.               type a directory name at the command line.
  945.  
  946.  
  947.               Faster and Better Batch Files
  948.  
  949.               4DOS speeds up traditional DOS batch files, and introduces a
  950.               new kind of batch file processing that is 5 to 10 times faster
  951.               than traditional batch files as well.  (See page 99.)
  952.  
  953.  
  954.           ___________________________________________________________________
  955.           Copyright 1993, JP Software Inc.        4DOS Reference Manual  /  9
  956.  
  957.                                                     CHAPTER 1 / 4DOS FEATURES
  958.           ___________________________________________________________________
  959.  
  960.  
  961.               In addition, 4DOS has more than two dozen new batch file
  962.               commands, and many other enhancements that will make your
  963.               batch files easier to write and far more powerful.
  964.  
  965.  
  966.               Command Line Enhancements
  967.  
  968.               4DOS replaces the traditional command line with a much
  969.               friendlier and more powerful command line environment.  Among
  970.               the features which 4DOS offers are:
  971.  
  972.                    Command Line Editing:  You can use the cursor keys to
  973.                    make corrections, in the same way that you would with a
  974.                    text editor.   (See page 55.)
  975.  
  976.                    Command History and Recall:  4DOS keeps track of each
  977.                    command you type.  You can recall any command and issue
  978.                    it again, or edit it to create a slightly different
  979.                    command.   Commands can be recalled one at a time, or you
  980.                    can pop up a window of recently entered commands and
  981.                    choose the one you want.  (See page 56.)
  982.  
  983.                    Automatic Filename Expansion:  If you type part of a
  984.                    filename, with or without wildcards, 4DOS will fill in
  985.                    the complete filename for you at the touch of a key.
  986.                    (See page 59.)
  987.  
  988.                    Multiple Commands on a Single Line:  You can type a
  989.                    series of commands on a single line instead of waiting
  990.                    for each one to finish before you issue the next one.
  991.                    (See page 61.)
  992.  
  993.                    Multiple Filenames:  Most 4DOS commands can operate on
  994.                    multiple files at once.  For example, you can copy
  995.                    several files at once from your hard drive to drive A
  996.                    with a command like:
  997.  
  998.                         copy *.wks *.dat *.txt  a:\
  999.  
  1000.                    Point-and-Shoot File Selection:  The SELECT command lets
  1001.                    you choose files with the cursor keys instead of
  1002.                    remembering their names.  It gives you a full "point-and-
  1003.                    shoot" environment for other 4DOS commands.   (See page
  1004.                    296.)
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.           ___________________________________________________________________
  1012.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  10
  1013.  
  1014.                                                     CHAPTER 1 / 4DOS FEATURES
  1015.           ___________________________________________________________________
  1016.  
  1017.  
  1018.               Aliases
  1019.  
  1020.               An alias is a command you create, assigned to a name you
  1021.               select or to a key combination of your choosing.  You can use
  1022.               aliases to rename commands, to set command defaults, and to
  1023.               create new commands that are a combination of other commands.
  1024.               When aliases are combined with the 4DOS multiple command
  1025.               feature, they act like very fast batch files.   (See pages 96
  1026.               and 173.)
  1027.  
  1028.  
  1029.               File Descriptions
  1030.  
  1031.               4DOS lets you assign a description (up to 40 characters long)
  1032.               to each of your files and directories.  The descriptions are
  1033.               displayed with the DIR and SELECT commands, and move with
  1034.               their files when you use a COPY, DEL, MOVE, or RENAME command.
  1035.               (See page 208.)
  1036.  
  1037.  
  1038.               Executable Extensions
  1039.  
  1040.               Executable extensions let you associate a file extension with
  1041.               the program that processes files of that type.  For example,
  1042.               you could associate .BAS files with the BASIC interpreter, or
  1043.               .DBF files with dBase or Foxbase.  4DOS runs the appropriate
  1044.               program automatically whenever you type the name of a file
  1045.               that has an extension you have defined as executable.  (See
  1046.               page 76.)
  1047.  
  1048.  
  1049.               Compatibility
  1050.  
  1051.               You can use 4DOS:
  1052.  
  1053.                    *  with all monochrome, CGA, EGA, and VGA video systems,
  1054.                       with any number of screen rows and columns.
  1055.  
  1056.                    *  with DOS-compatible networks, including Novell Netware,
  1057.                       3Com 3+, Banyan Vines, and Artisoft LANTastic.
  1058.  
  1059.                    *  with all popular memory managers and task switchers.
  1060.  
  1061.                    *  with virtually all commercial applications, utility
  1062.                       programs, and memory-resident utilities (TSRs).
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.           ___________________________________________________________________
  1069.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  11
  1070.  
  1071.                                                     CHAPTER 1 / 4DOS FEATURES
  1072.           ___________________________________________________________________
  1073.  
  1074.  
  1075.               New Commands and Options
  1076.  
  1077.               4DOS includes over 80 commands.  A few are the same as
  1078.               traditional commands.  Many are compatible with traditional
  1079.               commands but are enhanced with several additional options.
  1080.               The majority are unique to 4DOS.  If you have always wished
  1081.               that DOS had a command to help in a special situation, you
  1082.               will probably find that command in 4DOS.  A complete list of
  1083.               4DOS commands and options, along with explanations of how to
  1084.               use them, begins on page 166.
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.           ___________________________________________________________________
  1126.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  12
  1127.  
  1128.                                                      CHAPTER 2 / INSTALLATION
  1129.           ___________________________________________________________________
  1130.  
  1131.  
  1132.  
  1133.           CHAPTER 2 / INSTALLATION
  1134.  
  1135.  
  1136.           Before you install 4DOS (or any other software, for that matter),
  1137.           you should make a bootable system diskette so you can recover in
  1138.           case of a power failure or other interruption during the
  1139.           installation process.  To do so, put a fresh diskette in drive A
  1140.           and then type:
  1141.  
  1142.                    format a: /s
  1143.  
  1144.           The FORMAT command will take a few minutes to prepare the floppy
  1145.           diskette and then will copy your system files to drive A.  Once the
  1146.           process is complete, you should test your bootable floppy by
  1147.           leaving it in drive A and simultaneously pressing the Ctrl, Alt,
  1148.           and Del keys to make sure your system will boot up properly.  Once
  1149.           that's done, put the floppy away in a safe place and reboot your
  1150.           computer normally.
  1151.  
  1152.           The text below describes both automated and manual installation
  1153.           methods.  If you have a diskette copy of 4DOS, you can use either
  1154.           method.  If you have a downloaded copy, you must use manual
  1155.           installation.  If you are updating from a previous version of 4DOS,
  1156.           be sure to look through the update instructions for the new version
  1157.           in the README.DOC file.
  1158.  
  1159.  
  1160.           Automated Installation
  1161.  
  1162.               Now you are ready to install 4DOS.  Put the distribution
  1163.               diskette into your first disk drive, drive A. (You can use
  1164.               drive B if you prefer.)  Then log onto drive A by typing:
  1165.  
  1166.                    a:
  1167.  
  1168.               and press the Enter key.  One of the files on the distribution
  1169.               diskette, README.1ST, contains information that you should
  1170.               read before you install 4DOS on your computer.  Type:
  1171.  
  1172.                    type readme.1st
  1173.  
  1174.               to view the file.  If you want to print a copy of the file,
  1175.               type:
  1176.  
  1177.                    copy readme.1st prn
  1178.  
  1179.               Now you can start the installation process.  Type:
  1180.  
  1181.  
  1182.           ___________________________________________________________________
  1183.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  13
  1184.  
  1185.                                                      CHAPTER 2 / INSTALLATION
  1186.           ___________________________________________________________________
  1187.  
  1188.  
  1189.                    install
  1190.  
  1191.               and press the Enter key.  If you are using a color video
  1192.               adapter with a monochrome monitor (for example, a laptop
  1193.               computer with a monochrome EGA display), type:
  1194.  
  1195.                    install /m
  1196.  
  1197.               Once the installation program has started, just follow the
  1198.               instructions on the screen and 4DOS will install itself on
  1199.               your system.
  1200.  
  1201.               The installation program will ask whether you want to perform
  1202.               a complete installation, a partial installation in order to
  1203.               run the 4DOS Tour, or whether you want to retrieve specific
  1204.               files from the 4DOS library.  Choose the full installation to
  1205.               put all of 4DOS on your system, or the Tour option if you want
  1206.               to see what 4DOS can do before you install it permanently.
  1207.               The installation program will not make any changes to your
  1208.               CONFIG.SYS or AUTOEXEC.BAT files unless you give it permission
  1209.               to do so.
  1210.  
  1211.               If you elect to perform a full installation, reboot your
  1212.               computer when the installation program is done.  You will then
  1213.               have all the power of 4DOS available to you.
  1214.  
  1215.               We know some users feel unsure about running automated
  1216.               installation programs on their computers.  4DOS's automated
  1217.               installation is carefully written to be very well-behaved.  It
  1218.               won't modify or erase any existing files without asking you,
  1219.               and it takes a very straightforward, step by step approach.
  1220.  
  1221.               You can halt the installation process at any time and return
  1222.               to the DOS prompt by pressing Ctrl-X (hold down the Ctrl key
  1223.               and then press "X").
  1224.  
  1225.  
  1226.           ## Manual Installation
  1227.  
  1228.               For diskette copies of 4DOS, the 4DOS files are contained in a
  1229.               special library file on the distribution diskette.  You cannot
  1230.               simply copy files from the diskette onto your system.  You
  1231.               must use the installation program to extract and decompress
  1232.               the 4DOS files if you want to perform a manual installation,
  1233.               or if you need to replace a damaged 4DOS file on your hard
  1234.               disk.
  1235.  
  1236.  
  1237.  
  1238.  
  1239.           ___________________________________________________________________
  1240.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  14
  1241.  
  1242.                                                      CHAPTER 2 / INSTALLATION
  1243.           ___________________________________________________________________
  1244.  
  1245.  
  1246.               If you want to install 4DOS manually from diskette, first
  1247.               start the automatic installation program using the
  1248.               instructions above.  Select the Extract all files option and
  1249.               extract the 4DOS files onto your hard disk or another floppy
  1250.               disk.  On a hard disk, place the files in their own directory.
  1251.               If you are upgrading from a previous version of 4DOS, use a
  1252.               new directory -- don't overwrite your existing files.
  1253.  
  1254.               To install 4DOS manually from a downloaded copy, follow the
  1255.               same procedure but extract the files using the appropriate
  1256.               decompression program for the file you have downloaded
  1257.               (usually this is PKUNZIP.EXE, since 4DOS files are usually
  1258.               distributed in ZIP format).
  1259.  
  1260.               Once you've extracted the files, you can go through the 4DOS
  1261.               Tour (see page 18) if you want to try 4DOS before completing
  1262.               the installation.  When you're ready to finish the
  1263.               installation process, all you need to do is add one line to
  1264.               your CONFIG.SYS file (before modifying CONFIG.SYS, be sure you
  1265.               have a bootable floppy disk as discussed above):
  1266.  
  1267.                    SHELL=D:\PATH\4DOS.COM D:\PATH /P
  1268.  
  1269.               "d:\path" means the drive and directory where your 4DOS files
  1270.               are stored.  The second "d:\path" on the SHELL= line sets the
  1271.               COMSPEC environment variable, and can be left out if 4DOS.COM
  1272.               is in the root directory of your boot drive.  Be sure to
  1273.               delete or REMark out any old SHELL= line for COMMAND.COM after
  1274.               you add the new SHELL= line for 4DOS.
  1275.  
  1276.               Next, add the following line to your AUTOEXEC.BAT file:
  1277.  
  1278.                    D:\PATH\KSTACK.COM
  1279.  
  1280.               where "d:\path" is the drive and directory where your 4DOS
  1281.               files are stored.
  1282.  
  1283.               Once you've finished modifying CONFIG.SYS and AUTOEXEC.BAT,
  1284.               reboot your system to start 4DOS.  For details on setting up
  1285.               the SHELL= line and AUTOEXEC.BAT, and on the 4DOS.INI file,
  1286.               which controls 4DOS configuration, see Chapter 6 / Options and
  1287.               Tuning (page 109).
  1288.  
  1289.  
  1290.           ## Uninstalling 4DOS
  1291.  
  1292.               In the extremely unlikely event that you have trouble booting
  1293.               your computer after you install 4DOS, you can also remove it
  1294.  
  1295.  
  1296.           ___________________________________________________________________
  1297.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  15
  1298.  
  1299.                                                      CHAPTER 2 / INSTALLATION
  1300.           ___________________________________________________________________
  1301.  
  1302.  
  1303.               quite easily.  We don't expect you to have any trouble, but we
  1304.               know some people feel more comfortable knowing how to
  1305.               uninstall a product as well as install it.  Or, you may need
  1306.               to remove 4DOS from one system if you are moving it to another
  1307.               system.
  1308.  
  1309.               To temporarily remove 4DOS from your system, first find the
  1310.               location of COMMAND.COM on your disk (for example, in the root
  1311.               directory, or the DOS directory).  Boot the system and use any
  1312.               standard editor to edit your CONFIG.SYS file (before modifying
  1313.               CONFIG.SYS be sure you have a bootable floppy disk as
  1314.               discussed above).  Look for a line which begins:
  1315.  
  1316.                    SHELL=D:\PATH\4DOS.COM ...
  1317.  
  1318.               ("d:\path" means a drive letter and directory name).  Insert
  1319.               the characters "REM " at the beginning of this line.  This
  1320.               converts it into "remarks" or comments.  (If you are using DOS
  1321.               3 or below, REMarks are not recognized in CONFIG.SYS, so the
  1322.               changed lines will produce a harmless "Unrecognized command"
  1323.               error when the system boots.)  Next, add a new line like this:
  1324.  
  1325.                    SHELL=D:\PATH\COMMAND.COM /P
  1326.  
  1327.               where "d:\path" is the proper drive and directory for
  1328.               COMMAND.COM.  If you were previously running COMMAND.COM with
  1329.               a /E:nnnn switch to set the size of your environment, you can
  1330.               add it to this line as well.
  1331.  
  1332.               After CONFIG.SYS has been modified, edit your AUTOEXEC.BAT
  1333.               file to remove any changes made to accommodate 4DOS.  Look for
  1334.               two commands:
  1335.  
  1336.                    SET COMSPEC=D:\PATH\4DOS.COM
  1337.                    D:\PATH\KSTACK.COM
  1338.  
  1339.               The first command will not be present on most systems.  If
  1340.               it's there, change it to read:
  1341.  
  1342.                    SET COMSPEC=D:\PATH\COMMAND.COM
  1343.  
  1344.               where "d:\path" is replaced by the correct drive and directory
  1345.               for COMMAND.COM.  The second command can be deleted, or you
  1346.               can place "REM " in front of it to convert it to a comment.
  1347.               The second command may be present without the "d:\path"
  1348.               portion or the ".COM" portion; the key thing to look for is
  1349.               "KSTACK".  If you wish, you can look for the PATH command, and
  1350.               remove the 4DOS directory from the directories listed there.
  1351.  
  1352.  
  1353.           ___________________________________________________________________
  1354.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  16
  1355.  
  1356.                                                      CHAPTER 2 / INSTALLATION
  1357.           ___________________________________________________________________
  1358.  
  1359.  
  1360.               However, there's probably no reason to do so unless you're
  1361.               permanently removing 4DOS from your system.
  1362.  
  1363.               Now reboot your system, and you should be back up and running
  1364.               under COMMAND.COM.  Correct the problem that gave you trouble
  1365.               with 4DOS (contact our technical support department if you
  1366.               need help, see page 7).  Once the problem is fixed, edit your
  1367.               CONFIG.SYS file again to remove the REMs on your 4DOS lines
  1368.               and put one on your COMMAND.COM line instead, restore any
  1369.               COMSPEC command in AUTOEXEC.BAT, and you can boot with 4DOS
  1370.               again.
  1371.  
  1372.               To completely remove 4DOS from your system, change CONFIG.SYS
  1373.               and AUTOEXEC.BAT as described above, then delete your 4DOS
  1374.               files.
  1375.  
  1376.               Again, we don't expect you to need to use the procedure above
  1377.               -- but we thought you should have it anyway, just in case it
  1378.               makes you feel a little more at ease about installing a new
  1379.               product on your computer.
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.  
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404.  
  1405.  
  1406.  
  1407.  
  1408.  
  1409.  
  1410.           ___________________________________________________________________
  1411.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  17
  1412.  
  1413.                                             CHAPTER 3 / A GUIDED TOUR OF 4DOS
  1414.           ___________________________________________________________________
  1415.  
  1416.  
  1417.  
  1418.           CHAPTER 3 / A GUIDED TOUR OF 4DOS
  1419.  
  1420.  
  1421.           This chapter will acquaint you with some of the features of 4DOS.
  1422.           It isn't a substitute for the rest of the manual, but it will help
  1423.           you understand how familiar 4DOS seems if you are used to working
  1424.           at the traditional command prompt.  At the same time, it will
  1425.           introduce you to many of 4DOS's most popular features and
  1426.           enhancements.  By the time you finish working through this chapter,
  1427.           you will have a feeling for how easy and friendly 4DOS is compared
  1428.           to the traditional DOS command processor.
  1429.  
  1430.           This tour is designed to be used interactively.  Sit down at your
  1431.           computer with the manual.  Each time an example is shown, try it.
  1432.           The tour will create all of the files it uses;  it won't modify or
  1433.           change your existing files and subdirectories at all.  Each section
  1434.           of the tour is self-contained so you can skip any sections you wish
  1435.           and return to them later.
  1436.  
  1437.           If you come across terms or concepts in this chapter that you are
  1438.           unsure about, refer to Chapter 4 / General Concepts, the Glossary
  1439.           on page 355, or the Index.
  1440.  
  1441.  
  1442.           Starting The Tour
  1443.  
  1444.               Before you can start the tour, you need to install 4DOS.  If
  1445.               you haven't done so yet, see page 13 for instructions.  If you
  1446.               have a diskette copy of 4DOS, select "Tour Installation" from
  1447.               the INSTALL menu to copy the necessary 4DOS files to your disk
  1448.               without making any modifications to your CONFIG.SYS or
  1449.               AUTOEXEC.BAT files.  If you have already done a full
  1450.               installation and 4DOS is running on your system, just skip the
  1451.               step below that actually starts 4DOS (the step where the
  1452.               command "4DOS" is entered).
  1453.  
  1454.               During the course of the tour, we'll ask you to enter several
  1455.               commands.  The text that you should enter is always shown in
  1456.               bold type.  Your entries are shown here in lower case, but you
  1457.               can type in either upper or lower case.
  1458.  
  1459.               The computer's prompts and responses are displayed in normal,
  1460.               non-bold type.  The display may look slightly different on
  1461.               your system, depending on how your prompt is set up, what disk
  1462.               drive you're using, and what files are in your 4DOS directory.
  1463.               Don't worry about any minor differences.
  1464.  
  1465.  
  1466.  
  1467.           ___________________________________________________________________
  1468.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  18
  1469.  
  1470.                                             CHAPTER 3 / A GUIDED TOUR OF 4DOS
  1471.           ___________________________________________________________________
  1472.  
  1473.  
  1474.               In some cases, the computer's output will be too long to fit
  1475.               on a line of this manual and remain readable.  We've truncated
  1476.               those lines and placed three dots [...] at the end to show you
  1477.               that the actual line displayed on your screen will be a little
  1478.               longer.  Some commands create more lines of output than we
  1479.               need to display here to show how they work.  We've put a line
  1480.               of nine dots [... ... ...] in those locations to indicate that
  1481.               additional information will be shown on your screen.
  1482.  
  1483.               To start the tour, first change to the directory where 4DOS
  1484.               was installed, using the CD command.  For example, if you've
  1485.               installed 4DOS in the directory C:\4DOS, enter the following
  1486.               command:
  1487.  
  1488.                    C:\> cd 4dos
  1489.                    C:\4DOS>
  1490.  
  1491.               Now start 4DOS by typing:
  1492.  
  1493.                    C:\4DOS> 4dos
  1494.  
  1495.               You'll see a sign-on message from 4DOS that looks similar to
  1496.               this:
  1497.  
  1498.                    4DOS EMS swapping initialized (96K)
  1499.                    4DOS 4.0   DOS 5.0
  1500.                    Copyright 1988-1991  Rex Conn & JP Software Inc.  ...
  1501.                    Registered for use on a single computer.
  1502.  
  1503.               and then a prompt like this:
  1504.  
  1505.                    c:\4dos>
  1506.  
  1507.               Depending on how your prompt was previously defined, you may
  1508.               see the 4DOS prompt in lower case, which many people find
  1509.               easier to read.  A lower case prompt is the 4DOS default, and
  1510.               we'll show the prompt that way throughout the tour.  Once you
  1511.               have 4DOS installed you can use the PROMPT command (see page
  1512.               280) to change the prompt to upper case if you prefer.
  1513.  
  1514.               If you want to exit from 4DOS at any time, just type the
  1515.               command EXIT at the 4DOS prompt and press Enter.  This will
  1516.               return you to the traditional DOS command line:
  1517.  
  1518.                    c:\4dos> exit
  1519.                    C:\4DOS>
  1520.  
  1521.  
  1522.  
  1523.  
  1524.           ___________________________________________________________________
  1525.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  19
  1526.  
  1527.                                             CHAPTER 3 / A GUIDED TOUR OF 4DOS
  1528.           ___________________________________________________________________
  1529.  
  1530.  
  1531.           Basic Commands
  1532.  
  1533.               We'll begin the tour by demonstrating some of the most common,
  1534.               and most familiar, 4DOS commands.  We'll also show you some of
  1535.               the enhancements that 4DOS has added to those commands to make
  1536.               your computing easier.
  1537.  
  1538.               First, enter the single-character command ?.  You'll see a
  1539.               display like this:
  1540.  
  1541.                    c:\4dos> ?
  1542.                    ?           ALIAS       ATTRIB      BEEP        ...
  1543.                    CANCEL      CD          CDD         CHCP        ...
  1544.                    COLOR       COPY        CTTY        DATE        ...
  1545.                    DESCRIBE    DIR         DIRS        DRAWBOX     ...
  1546.                     ... ... ...
  1547.                    UNALIAS     UNSET       VER         VERIFY      ...
  1548.                    Y
  1549.  
  1550.               The ? command displays a list of all of 4DOS's commands.  You
  1551.               certainly don't have to memorize them all -- we'll show you
  1552.               how to get help with any command in a few moments.  Nor are we
  1553.               going to demonstrate all of these commands in this tour.  If
  1554.               you want complete information about a command, turn to the
  1555.               alphabetic Command Reference that begins on page 166.
  1556.  
  1557.               Now try a DIR command to see a list of files in the current
  1558.               directory.  DIR displays a list of file names, sizes, dates,
  1559.               and times:
  1560.  
  1561.                    c:\4dos> dir
  1562.  
  1563.                     Volume in drive C is JPS_TEST    Serial number is ...
  1564.                     Directory of  c:\4dos\*.*
  1565.  
  1566.                    .            <DIR>      8-22-91  14:21
  1567.                    ..           <DIR>      8-22-91  14:21
  1568.                    4dos.com        99280   8-26-91   4:00
  1569.                    4dos.doc       345005   8-26-91   4:00
  1570.                    4dos.ico          766   8-26-91   4:00
  1571.                    4dos.pif          545   8-26-91   4:00
  1572.                     ... ... ...
  1573.                    tour2.btm        2765   8-26-91   4:00
  1574.                    update40.doc    37946   8-26-91   4:00
  1575.                    vendor.doc       4434   8-26-91   4:00
  1576.                         833,056 bytes in 21 file(s)  851,968 bytes allocated
  1577.                      18,651,136 bytes free
  1578.  
  1579.  
  1580.  
  1581.           ___________________________________________________________________
  1582.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  20
  1583.  
  1584.                                             CHAPTER 3 / A GUIDED TOUR OF 4DOS
  1585.           ___________________________________________________________________
  1586.  
  1587.  
  1588.               The 4DOS DIR display should look familiar.  But, unlike the
  1589.               traditional DIR display, 4DOS shows file names in lower case
  1590.               and in alphabetical order.  4DOS also gives you some totals at
  1591.               the end of the display that help you see how much space your
  1592.               files are using.
  1593.  
  1594.               By using some of DIR's options, you can make the display
  1595.               easier to read.  The directory display you just saw probably
  1596.               didn't fit on your screen.  You can tell DIR to pause at the
  1597.               end of each page by using the command DIR /P.  The /P is an
  1598.               example of a switch or option which modifies the behavior of a
  1599.               command:
  1600.  
  1601.                    c:\4dos> dir /p
  1602.  
  1603.                     Volume in drive C is JPS_TEST    Serial number is ...
  1604.                     Directory of  c:\4dos\*.*
  1605.  
  1606.                    .            <DIR>      8-22-91  14:21
  1607.                    ..           <DIR>      8-22-91  14:21
  1608.                    4dos.com        99280   8-26-91   4:00
  1609.                    4dos.doc       345005   8-26-91   4:00
  1610.                    4dos.ico          766   8-26-91   4:00
  1611.                    4dos.pif          545   8-26-91   4:00
  1612.                     ... ... ...
  1613.                    tour2.btm        2765   8-26-91   4:00
  1614.                    update40.doc    37946   8-26-91   4:00
  1615.                    Press any key when ready...
  1616.                    vendor.doc       4434   8-26-91   4:00
  1617.                         833,056 bytes in 21 file(s)  851,968 bytes allocated
  1618.                      18,649,088 bytes free
  1619.  
  1620.               You might prefer to display directories in 2 columns.  DIR
  1621.               will do that if you include the /2 option.  If you add the /V
  1622.               option, it will perform a vertical sort, with file names
  1623.               running alphabetically down the first column and then down the
  1624.               second column.  (We've left off the end of the second column
  1625.               of the display, since it doesn't fit on a manual page.  You'll
  1626.               be able to see it on the screen.)
  1627.  
  1628.                    c:\4dos> dir /2/v
  1629.  
  1630.                     Volume in drive C is JPS_TEST    Serial number is ...
  1631.                     Directory of  c:\4dos\*.*
  1632.  
  1633.                    .            <DIR>      8-22-91  14:21   helpcfg.exe  ...
  1634.                    ..           <DIR>      8-22-91  14:21   kstack.com   ...
  1635.                    4dos.com        99280   8-26-91   4:00   order.frm    ...
  1636.  
  1637.  
  1638.           ___________________________________________________________________
  1639.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  21
  1640.  
  1641.                                             CHAPTER 3 / A GUIDED TOUR OF 4DOS
  1642.           ___________________________________________________________________
  1643.  
  1644.  
  1645.                    4dos.doc       345005   8-26-91   4:00   readme.doc   ...
  1646.                    4dos.ico          766   8-26-91   4:00   support.bbs  ...
  1647.                    4dos.pif          545   8-26-91   4:00   sysop.doc    ...
  1648.                    4dosm.ico         766   8-26-91   4:00   tour1.btm    ...
  1649.                    4help.exe       45632   8-26-91   4:00   tour2.btm    ...
  1650.                    aliases          8164   8-26-91   4:00   update40.doc ...
  1651.                    appnotes.doc    82722   8-26-91   4:00   vendor.doc   ...
  1652.                    4dos.hlp       120555   8-26-91   4:00
  1653.                         833,056 bytes in 21 file(s)  851,968 bytes allocated
  1654.                      18,653,184 bytes free
  1655.  
  1656.               DIR has many other formatting and file selection options.
  1657.               You'll use a few below; all of them are explained with the DIR
  1658.               command on page 210.
  1659.  
  1660.               Next, you'll use a simple batch file called TOUR1.BTM to
  1661.               create a dummy file.  (A .BTM batch file is similar to a
  1662.               traditional .BAT batch file but faster.  See page 99 for an
  1663.               explanation of the differences between the two.)  To run
  1664.               TOUR1.BTM, enter the command:
  1665.  
  1666.                    c:\4dos> tour1
  1667.  
  1668.               This batch file creates a small file called FILE1 in your
  1669.               current directory.  The contents of the file aren't important;
  1670.               we're simply using it to demonstrate some of 4DOS's file-
  1671.               handling capabilities.  You can verify that FILE1 has been
  1672.               created by using DIR again.
  1673.  
  1674.               Now use the COPY command to copy the contents of FILE1 to a
  1675.               new file, FILE2:
  1676.  
  1677.                    c:\4dos> copy file1 file2
  1678.                    c:\4dos\file1 => c:\4dos\file2
  1679.                         1 file(s) copied
  1680.  
  1681.               4DOS performed the copy just like the traditional COPY command
  1682.               does.  You may notice that the output is a little friendlier:
  1683.               COPY tells you exactly what file it copied and where it copied
  1684.               the file to, along with a count of files at the end.
  1685.  
  1686.               Now try renaming a file.  If you've used the traditional
  1687.               RENAME command or its synonym REN, this will look familiar:
  1688.  
  1689.                    c:\4dos> ren file1 file3
  1690.                    c:\4dos\file1 -> c:\4dos\file3
  1691.                         1 file(s) renamed
  1692.  
  1693.  
  1694.  
  1695.           ___________________________________________________________________
  1696.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  22
  1697.  
  1698.                                             CHAPTER 3 / A GUIDED TOUR OF 4DOS
  1699.           ___________________________________________________________________
  1700.  
  1701.  
  1702.               Like COPY, the 4DOS REN command tells you just what it did.
  1703.               You now have two files, FILE2 and FILE3, in the current
  1704.               directory.  You can use one of 4DOS's enhancements to add the
  1705.               extension .TST to both of them:
  1706.  
  1707.                    c:\4dos> ren file2 file3 *.tst
  1708.                    c:\4dos\file2 -> c:\4dos\file2.tst
  1709.                    c:\4dos\file3 -> c:\4dos\file3.tst
  1710.                         2 file(s) renamed
  1711.  
  1712.               Unlike the traditional REN command, 4DOS lets you rename
  1713.               multiple files with a single command.  All of the 4DOS file
  1714.               processing commands like COPY, DEL, MOVE, and RENAME accept
  1715.               multiple file names, so you can do in one command what used to
  1716.               require a separate command for each file.
  1717.  
  1718.               Now delete the files you have just created.  You could use a
  1719.               simple command like DEL *.TST, but that would delete any other
  1720.               .TST files in the current directory also.  To protect against
  1721.               erasing files that you might want to keep, add a /P option to
  1722.               DEL so that it will prompt you before it deletes each file.
  1723.               Answer Y to the prompts shown below to let 4DOS delete your
  1724.               test files:
  1725.  
  1726.                    c:\4dos> del *.tst /p
  1727.                    Delete c:\4dos\file3.tst (Y/N)? y
  1728.                    Delete c:\4dos\file2.tst (Y/N)? y
  1729.                         2 file(s) deleted
  1730.  
  1731.               To verify all these actions, you can do a DIR or DIR /P to
  1732.               look at what files are left in the directory.  All the files
  1733.               you've just created (FILE1, FILE2, FILE3, etc.) should be
  1734.               gone.
  1735.  
  1736.               The features we've demonstrated here -- traditional commands
  1737.               with enhancements that make your work easier -- are present
  1738.               throughout 4DOS.  If you want more details, pick a DOS command
  1739.               that you're familiar with and look up the corresponding 4DOS
  1740.               command in the reference section to get an idea of what's new
  1741.               and improved in 4DOS.  (Remember that 4DOS only replaces
  1742.               internal commands like COPY and DIR, not external commands
  1743.               like DISKCOPY and FORMAT.)
  1744.  
  1745.  
  1746.  
  1747.  
  1748.  
  1749.  
  1750.  
  1751.  
  1752.           ___________________________________________________________________
  1753.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  23
  1754.  
  1755.                                             CHAPTER 3 / A GUIDED TOUR OF 4DOS
  1756.           ___________________________________________________________________
  1757.  
  1758.  
  1759.           Command Line Editing and History
  1760.  
  1761.               This section demonstrates 4DOS features which make it easy to
  1762.               correct typing mistakes at the DOS prompt, to repeat previous
  1763.               commands, and to get help with any command.
  1764.  
  1765.               We can't show you exact examples here as easily as we can in
  1766.               the other sections of the tour, since the display depends on
  1767.               the exact keystrokes you type and we want you to experiment a
  1768.               little.  So we'll guide you through what 4DOS can do, and
  1769.               you'll see the results on your screen.
  1770.  
  1771.               First, create a typing error by mistake.  Enter an incorrect
  1772.               DIR command:
  1773.  
  1774.                    c:\4dos> dur /2
  1775.  
  1776.               Traditionally, you would have had to use the Backspace key to
  1777.               erase most of the line in order to correct this error, or
  1778.               press Esc and start over.  4DOS makes corrections much easier.
  1779.               Press the Home key followed by the right arrow.  The cursor
  1780.               will move to the start of the line and then right one space to
  1781.               the "u" in "dur".  Type an "i" and the command should be
  1782.               correct.  To execute it, press Enter;  if you'd rather not,
  1783.               press Esc.
  1784.  
  1785.               That's a simple example of 4DOS's command line editing.  You
  1786.               can use the left and right arrow keys, Home and End, and
  1787.               Backspace and Del to move around and modify your command line
  1788.               at any time, just like you do in your word processor or
  1789.               editor.  Other keys let you move the cursor a word at a time,
  1790.               delete words, change between overstrike and insert modes, and
  1791.               perform many other operations.  Esc always clears the line and
  1792.               lets you start over.  For a summary of all the command line
  1793.               editing keys see page 55, or your 4DOS Quick Reference card.
  1794.  
  1795.               4DOS also remembers the commands you type in a command
  1796.               history.  To see the commands you have used so far during this
  1797.               tour, we'll use the 4DOS HISTORY command to display the entire
  1798.               history list:
  1799.  
  1800.                    c:\4dos> history
  1801.                    ?
  1802.                    dir
  1803.                    dir /p
  1804.                    dir /2/v
  1805.                    tour1
  1806.                    ren file1 file3
  1807.  
  1808.  
  1809.           ___________________________________________________________________
  1810.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  24
  1811.  
  1812.                                             CHAPTER 3 / A GUIDED TOUR OF 4DOS
  1813.           ___________________________________________________________________
  1814.  
  1815.  
  1816.                    ren file2 file3 *.tst
  1817.                    del *.tst /p
  1818.                    dir /2
  1819.  
  1820.               4DOS records about 1000 characters of history.  You can reduce
  1821.               or enlarge this amount to suit your own needs.
  1822.  
  1823.               Now press the up-arrow key once.  The last command in the
  1824.               HISTORY display (DIR /2 in the example above) will appear at
  1825.               the prompt.  You can use the editing keys to modify this
  1826.               command, which is much easier than retyping it.  To execute
  1827.               the command again, in either its modified or unmodified form,
  1828.               press Enter.  To clear the line, press Esc.
  1829.  
  1830.               If you'd like to see more commands, first press Esc to clear
  1831.               the command line. (To see all commands in the history, you
  1832.               should always start with an empty command line.)  Now press
  1833.               up-arrow several times.  Each time you press it, 4DOS will
  1834.               back up one more line in the command history.  Once you find
  1835.               the line you're looking for, you can modify it if you like and
  1836.               then press Enter to execute it.
  1837.  
  1838.               Now imagine that you have been working for a while.  An hour
  1839.               ago you did a complex DIR command and you need to do it again.
  1840.               You could scroll through an hour's worth of command history.
  1841.               But another 4DOS feature called command completion will save
  1842.               you time.
  1843.  
  1844.               First, type the beginning of the command -- DI, or DIR.  Now
  1845.               press the up-arrow.  4DOS will recall the newest command in
  1846.               the history that starts with the characters you typed (if
  1847.               there are no matches, 4DOS beeps).  Press up-arrow again to
  1848.               retrieve the command before that, still matching to the
  1849.               characters you originally typed.
  1850.  
  1851.               You can test this out easily using DI or DIR, because you've
  1852.               put several DIR commands into the command history during the
  1853.               tour.
  1854.  
  1855.               Perhaps you would prefer to look at a list of commands that
  1856.               you have entered and choose from the list.  First press the
  1857.               Esc key to clear the command prompt.  Then press the PgUp key.
  1858.               4DOS will display a history window in the upper right corner
  1859.               of your screen showing the commands you've recently typed.
  1860.               You can move around in this window with the up-arrow and down-
  1861.               arrow keys.  PgUp and PgDn move the display a page at a time.
  1862.               When you find the command you want, press Enter to re-execute
  1863.  
  1864.  
  1865.  
  1866.           ___________________________________________________________________
  1867.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  25
  1868.  
  1869.                                             CHAPTER 3 / A GUIDED TOUR OF 4DOS
  1870.           ___________________________________________________________________
  1871.  
  1872.  
  1873.               it as is, or press Ctrl-Enter to move the line down to the
  1874.               prompt where you can edit it as usual.
  1875.  
  1876.               You can find more information on command line editing and
  1877.               history beginning on pages 55 and 56.  And you can use
  1878.               directives in your 4DOS.INI file (see page 119) to set the
  1879.               length of the history list and the size of the history window,
  1880.               and to redefine the editing and history keys.
  1881.  
  1882.               You can also get help any time you need it from the 4DOS
  1883.               command prompt.  Just press the F1 key.  You'll see a display
  1884.               of all of 4DOS's HELP topics.  If you would like some help
  1885.               with COPY, move the cursor bar to COPY, or just type COPY and
  1886.               4DOS will move the bar for you.  Press Enter to see help on
  1887.               the topic;  once you're there, scroll through the help using
  1888.               the vertical arrows or PgUp and PgDn keys.  The highlighted
  1889.               items within a topic are cross-references to other topics;
  1890.               select one with the horizontal arrow keys and press Enter to
  1891.               view it.  Press Esc or F1 to return to the topic list.
  1892.  
  1893.               For more help using the Help display, select the topic -HELP-
  1894.               from the topic list.  If you have a mouse, also see the -HELP-
  1895.               topic for information on using the mouse within the Help
  1896.               system.
  1897.  
  1898.               Now exit the help system (use Esc) and start entering a
  1899.               command:
  1900.  
  1901.                    c:\4dos> copy *.doc a: /
  1902.  
  1903.               After that "/" you want to use the option that tells COPY to
  1904.               prompt you before replacing an existing file, but you can't
  1905.               remember what it is.  Just leave the command as it is and
  1906.               press F1.  4DOS will display help on the command you're
  1907.               entering, and you'll see that the option you want is /R.
  1908.               Press Esc to exit help and you'll be right back on the command
  1909.               line.  You can type the R and press Enter to execute your
  1910.               command, or press Esc instead to clear the line if you don't
  1911.               really want to execute the command.
  1912.  
  1913.               4DOS has may more features that can help you at the command
  1914.               line.  Most of them are described in Chapter 5 / Using 4DOS,
  1915.               in the section At the Command Line starting on page 54.
  1916.  
  1917.  
  1918.  
  1919.  
  1920.  
  1921.  
  1922.  
  1923.           ___________________________________________________________________
  1924.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  26
  1925.  
  1926.                                             CHAPTER 3 / A GUIDED TOUR OF 4DOS
  1927.           ___________________________________________________________________
  1928.  
  1929.  
  1930.           More About Files
  1931.  
  1932.               This section of the tour lets you explore some more of 4DOS's
  1933.               features that will help you manage files and directories.
  1934.               You're about to use another batch file to create some files
  1935.               with which you can experiment.  The batch file you'll use is
  1936.               called TOUR2.BTM.  First, take a look at the batch file with
  1937.               the 4DOS LIST command:
  1938.  
  1939.                    c:\4dos> list tour2.btm
  1940.  
  1941.               As you can see on your screen, LIST is a full screen file
  1942.               viewer.  You can scroll and page through the text.  You may
  1943.               notice that some lines near the end of the file extend beyond
  1944.               the edge of your screen.  To make the off-screen text visible
  1945.               use the left and right arrows to scroll the display
  1946.               horizontally, or press W to turn line wrapping on and off.
  1947.               LIST also lets you search for text and print the file you're
  1948.               viewing, two capabilities that we won't demonstrate on this
  1949.               tour.  The file TOUR2.BTM is simply a batch file that creates
  1950.               other files, using 4DOS's ECHO command.  You don't have to
  1951.               worry about how it works; we just used it to show you LIST.
  1952.  
  1953.               Now run TOUR2.BTM:
  1954.  
  1955.                    c:\4dos> tour2
  1956.  
  1957.                    Please wait ...
  1958.  
  1959.                    File creation completed
  1960.  
  1961.               TOUR2 creates three files called FILE1, FILE2, and FILE3.  The
  1962.               contents of the files aren't important since we're just using
  1963.               them for demonstration purposes.  You'll be deleting and
  1964.               recreating them several times through the rest of the tour.
  1965.  
  1966.               Now try 4DOS's SELECT feature.  SELECT lets you choose files
  1967.               for any 4DOS command from a full-screen list.  We'll use it
  1968.               here to delete one of the files that TOUR2 created.  Enter the
  1969.               command:
  1970.  
  1971.                    c:\4dos> select del (file*)
  1972.  
  1973.               This command tells 4DOS to let you select from files that
  1974.               begin with the characters "file", and then pass the name of
  1975.               each file you select to the DEL command for action.
  1976.  
  1977.  
  1978.  
  1979.  
  1980.           ___________________________________________________________________
  1981.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  27
  1982.  
  1983.                                             CHAPTER 3 / A GUIDED TOUR OF 4DOS
  1984.           ___________________________________________________________________
  1985.  
  1986.  
  1987.               The display on your screen should include a two-line header
  1988.               and then the list of files, just as they'd look in a directory
  1989.               display.  Press the spacebar to "mark" the first file -- a
  1990.               triangular mark will appear to the left of the file name.  You
  1991.               can scroll around in the display and mark and unmark files
  1992.               with the spacebar as you like.  When you hit Enter, the
  1993.               command will be executed, deleting the files you've marked.
  1994.               For now, mark FILE1 and leave the other files unmarked, so
  1995.               that FILE2 and FILE3 are not deleted.  You'll use them in the
  1996.               next step.
  1997.  
  1998.               SELECT is also handy if you want to copy a group of files to a
  1999.               floppy disk, perhaps to take your work home for the night or
  2000.               to make a quick backup.  If you'd like to try it, put a blank,
  2001.               formatted floppy disk in drive A.  Then enter this command:
  2002.  
  2003.                    c:\4dos> select copy (file*) a:
  2004.  
  2005.               Mark one or both of the files in the SELECT display, and the
  2006.               marked file(s) will be copied to the floppy disk when you hit
  2007.               Enter.
  2008.  
  2009.               SELECT is a "prefix" command:  it goes before another command
  2010.               and modifies what that second command does.  Another useful
  2011.               prefix command is EXCEPT,  which lets you do something except
  2012.               to one or more files.  Before you try EXCEPT, create new
  2013.               copies of FILE1, FILE2, and FILE3 (TOUR2 will overwrite any
  2014.               old copies of these files remaining from the last time it was
  2015.               run):
  2016.  
  2017.                    c:\4dos> tour2
  2018.  
  2019.                    Please wait ...
  2020.  
  2021.                    File creation completed
  2022.  
  2023.               Now use EXCEPT to delete all but one of the files that TOUR2
  2024.               created:
  2025.  
  2026.                    c:\4dos> except (file1) del file*
  2027.                    Deleting c:\4dos\file2
  2028.                    Deleting c:\4dos\file3
  2029.                         2 file(s) deleted
  2030.  
  2031.               The EXCEPT command protected FILE1 from being deleted.  To
  2032.               verify that, use the DIR command.  When you're done, run TOUR2
  2033.               one more time so the files are there for the next step.
  2034.  
  2035.  
  2036.  
  2037.           ___________________________________________________________________
  2038.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  28
  2039.  
  2040.                                             CHAPTER 3 / A GUIDED TOUR OF 4DOS
  2041.           ___________________________________________________________________
  2042.  
  2043.  
  2044.               Next, create two subdirectories within the current directory:
  2045.  
  2046.                    c:\4dos> md dira dirb
  2047.  
  2048.               Notice that you can create both subdirectories with a single
  2049.               command.  Traditionally, you would have needed two MD commands
  2050.               to do the same thing.  To verify that the directories are
  2051.               there, use DIR but ask it to display only subdirectories and
  2052.               not files (if you're curious, /A:D stands for "Attributes:
  2053.               Directory";  see page 210 for more details):
  2054.  
  2055.                    c:\4dos> dir /a:d
  2056.  
  2057.                     Volume in drive C is JPS_TEST  Serial number is ...
  2058.                     Directory of  c:\4dos\*.*
  2059.  
  2060.                    .            <DIR>      8-22-91  14:21
  2061.                    ..           <DIR>      8-22-91  14:21
  2062.                    DIRA         <DIR>      8-27-91  10:23
  2063.                    DIRB         <DIR>      8-27-91  10:23
  2064.                               0 bytes in 4 file(s)         0 bytes allocated
  2065.                      18,608,128 bytes free
  2066.  
  2067.               OK, things look right.  Now move the demonstration files to
  2068.               those directories.  4DOS has a built-in MOVE command to move a
  2069.               file from one directory or drive to another, something DOS
  2070.               users have wished for for a long time.
  2071.  
  2072.               Here are the commands to move FILE1 to DIRA, and FILE2 and
  2073.               FILE3 to DIRB:
  2074.  
  2075.                    c:\4dos> move file1 dira
  2076.                    c:\4dos\file1 -> c:\4dos\dira\file1
  2077.                         1 file(s) moved
  2078.  
  2079.                    c:\4dos> move file2 file3 dirb
  2080.                    c:\4dos\file2 -> c:\4dos\dirb\file2
  2081.                    c:\4dos\file3 -> c:\4dos\dirb\file3
  2082.                         2 file(s) moved
  2083.  
  2084.               As usual, 4DOS tells you exactly what it's doing.
  2085.  
  2086.               Now that you've created a subdirectory structure, it's time to
  2087.               get a comprehensive look at it.  Use DIR to look for all the
  2088.               files whose names begin with "file" in the current directory
  2089.               and all of its subdirectories -- that's the DIR /S option:
  2090.  
  2091.                    c:\4dos> dir /s file*
  2092.  
  2093.  
  2094.           ___________________________________________________________________
  2095.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  29
  2096.  
  2097.                                             CHAPTER 3 / A GUIDED TOUR OF 4DOS
  2098.           ___________________________________________________________________
  2099.  
  2100.  
  2101.  
  2102.                     Volume in drive C is JPS_TEST    Serial number is ...
  2103.                     Directory of  c:\4dos\dira\file*.*
  2104.  
  2105.                    file1              22   8-27-91  10:37
  2106.                              22 bytes in 1 file(s)     2,048 bytes allocated
  2107.                      18,587,648 bytes free
  2108.  
  2109.                        Total for:  c:\4dos\dira\file*.*
  2110.                              22 bytes in 1 file(s)     2,048 bytes allocated
  2111.  
  2112.                     Directory of  c:\4dos\dirb\file*.*
  2113.  
  2114.                    file2              22   8-27-91  10:37
  2115.                    file3            1938   8-27-91  10:37
  2116.                           1,960 bytes in 2 file(s)     4,096 bytes allocated
  2117.                      18,587,648 bytes free
  2118.  
  2119.                        Total for:  c:\4dos\dirb\file*.*
  2120.                           1,960 bytes in 2 file(s)     4,096 bytes allocated
  2121.  
  2122.                        Total for:  c:\4dos\file*.*
  2123.                           1,982 bytes in 3 file(s)     6,144 bytes allocated
  2124.  
  2125.               DIR has displayed the directory header, filenames, and totals
  2126.               for each of the two subdirectories that contain files matching
  2127.               the name you entered, FILE*.  It also has displayed a grand
  2128.               total.
  2129.  
  2130.               You've seen that DIR can look at several subdirectories at
  2131.               once.  Now do the same thing with DEL, and delete the files
  2132.               you put in your demonstration subdirectories, along with the
  2133.               subdirectories themselves, with a single command.  To do so,
  2134.               you need to use two options: /S and /X.  The first tells DEL
  2135.               to delete files in the current directory and all of its
  2136.               subdirectories.  The /X option makes DEL remove each
  2137.               subdirectory if all the files within it are deleted:
  2138.  
  2139.                    c:\4dos> del /s/x dira dirb
  2140.                    c:\4dos\dira\*.* : Are you sure (Y/N)? Y
  2141.                    Deleting c:\4dos\dira\file1
  2142.                    c:\4dos\dirb\*.* : Are you sure (Y/N)? Y
  2143.                    Deleting c:\4dos\dirb\file2
  2144.                    Deleting c:\4dos\dirb\file3
  2145.                         3 file(s) deleted
  2146.  
  2147.               Note the safety feature that 4DOS gave you here.  When you
  2148.               tell DEL to delete DIRA and DIRB, 4DOS recognizes them as
  2149.  
  2150.  
  2151.           ___________________________________________________________________
  2152.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  30
  2153.  
  2154.                                             CHAPTER 3 / A GUIDED TOUR OF 4DOS
  2155.           ___________________________________________________________________
  2156.  
  2157.  
  2158.               directory names and assumes you mean "delete all files in this
  2159.               directory".  Since you're deleting all the files, 4DOS
  2160.               displays a prompt that tells you what's about to be deleted
  2161.               and asks you whether you really want to do the deletion.  Once
  2162.               you answer Y, the files are deleted and the subdirectory is
  2163.               automatically removed because you used the /X switch.
  2164.  
  2165.               4DOS also lets you use file descriptions, so you can describe
  2166.               a file's contents more clearly than with an 8-character file
  2167.               name.  The descriptions can be up to 40 characters long.
  2168.  
  2169.               First, run TOUR2 again to regenerate the three demonstration
  2170.               files.  Then enter a DESCRIBE command, along with a
  2171.               description for each file (you can enter any description you
  2172.               like; you don't have to use the text shown):
  2173.  
  2174.                    c:\4dos> tour2
  2175.                    c:\4dos> describe file*
  2176.                    Describe "c:\4dos\file1" : Tour file 1
  2177.                    Describe "c:\4dos\file2" : Tour file 2
  2178.                    Describe "c:\4dos\file3" : Tour file 3
  2179.  
  2180.               Now look at the descriptions with a DIR command:
  2181.  
  2182.                    c:\4dos> dir file*
  2183.  
  2184.                     Volume in drive C is JPS_TEST    Serial number is ...
  2185.                     Directory of  c:\4dos\file*.*
  2186.  
  2187.                    file1              22   8-27-91  10:48 Tour file 1
  2188.                    file2              22   8-27-91  10:48 Tour file 2
  2189.                    file3            1938   8-27-91  10:49 Tour file 3
  2190.                           1,982 bytes in 3 file(s)     6,144 bytes allocated
  2191.                      18,604,032 bytes free
  2192.  
  2193.               The descriptions will appear any time you ask for a standard,
  2194.               single-column directory display.  They will also appear when
  2195.               you use the SELECT command.  They can be a lifesaver when you
  2196.               have files whose contents you can't remember, or when you have
  2197.               large groups of files with similar names.
  2198.  
  2199.  
  2200.           Directory Navigation
  2201.  
  2202.               4DOS doesn't just make it easier to access files;  it also
  2203.               makes your life much easier when you're navigating through the
  2204.               hard disk directory structure.  You're probably already
  2205.               familiar with the traditional CD command, which you use to
  2206.  
  2207.  
  2208.           ___________________________________________________________________
  2209.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  31
  2210.  
  2211.                                             CHAPTER 3 / A GUIDED TOUR OF 4DOS
  2212.           ___________________________________________________________________
  2213.  
  2214.  
  2215.               change directories.  4DOS adds a "go back" option to CD, which
  2216.               is invoked by using the minus sign [-] instead of a directory
  2217.               name.  Try this:
  2218.  
  2219.                    c:\4dos> cd \
  2220.                    c:\> cd -
  2221.                    c:\4dos>
  2222.  
  2223.               The CD - changes back to the directory you were in before the
  2224.               most recent CD command.  It's a convenient way to switch back
  2225.               and forth between two directories.
  2226.  
  2227.               4DOS also lets you change the drive and directory at the same
  2228.               time with the CDD command so you don't have to switch drives
  2229.               first and then change directories.  Here's an example using
  2230.               CDD.  Before you try it, put a floppy disk in drive A:
  2231.  
  2232.                    c:\4dos> cdd a:\
  2233.                    a:\> cdd -
  2234.                    c:\4dos>
  2235.  
  2236.               As you can see, the minus works with CDD as well.
  2237.  
  2238.               For more complex sequences of directory navigation, you can
  2239.               use PUSHD and POPD.  These commands maintain a directory
  2240.               "stack" and let you make several changes, then move back
  2241.               through the directories you've been to.  They can change both
  2242.               drive and directory, like CDD.  For example:
  2243.  
  2244.                    c:\4dos> pushd a:\
  2245.                    a:\> pushd c:\
  2246.                    c:\> popd
  2247.                    a:\> popd
  2248.                    c:\4dos>
  2249.  
  2250.               4DOS also offers you a special environment variable, CDPATH,
  2251.               to help you find the right directory without a lot of typing.
  2252.               CD, CDD, and PUSHD use CDPATH to find the directory you want
  2253.               to change to if they can't find it in the current directory.
  2254.               This can help a lot when you have long but commonly used
  2255.               directory names.  For example, say you have a directory called
  2256.               C:\DBASE\REPORTS which contains a subdirectory for each month
  2257.               of the year.  If you set CDPATH like this:
  2258.  
  2259.                    c:\4dos> set cdpath=c:\dbase\reports
  2260.  
  2261.               Then you can change to the JANUARY subdirectory like this:
  2262.  
  2263.  
  2264.  
  2265.           ___________________________________________________________________
  2266.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  32
  2267.  
  2268.                                             CHAPTER 3 / A GUIDED TOUR OF 4DOS
  2269.           ___________________________________________________________________
  2270.  
  2271.  
  2272.                    c:\4dos> cd january
  2273.                    c:\dbase\reports\january> cd -
  2274.                    c:\4dos>
  2275.  
  2276.               CD found the JANUARY subdirectory, saving you from typing the
  2277.               entire name, because its parent directory was listed in
  2278.               CDPATH.  For more details about CDPATH see page 117.
  2279.  
  2280.  
  2281.           Aliases
  2282.  
  2283.               Aliases are one of 4DOS's most powerful features.  Simple
  2284.               aliases are very easy to set up and use (that's what we'll
  2285.               discuss here).  Complex aliases allow you to configure your
  2286.               system just about any way you want, and can take the place of
  2287.               many small batch files.
  2288.  
  2289.               The purpose of aliases is to rename or reconfigure 4DOS
  2290.               commands.  They are defined and viewed with the ALIAS command.
  2291.               In this tour, we'll show you how to set up aliases for the DIR
  2292.               command.  Of course, you can use aliases to enhance any
  2293.               command; for more examples see the ALIAS command on page 173,
  2294.               and the sample file ALIASES that comes with 4DOS.
  2295.  
  2296.               Here's a popular favorite for anyone who uses DIR and wants to
  2297.               be able to use a simple D instead:
  2298.  
  2299.                    c:\4dos> alias d = dir
  2300.  
  2301.               To see what aliases you've defined, enter ALIAS with no
  2302.               parameters:
  2303.  
  2304.                    c:\4dos> alias
  2305.                    d=dir
  2306.  
  2307.               To use the alias, just enter its name at the prompt, like any
  2308.               command:
  2309.  
  2310.                    c:\4dos> d
  2311.  
  2312.                     Volume in drive C is JPS_TEST    Serial number is ...
  2313.                     Directory of  c:\4dos\*.*
  2314.  
  2315.                    .            <DIR>      8-22-91  14:21
  2316.                    ..           <DIR>      8-22-91  14:21
  2317.                    4dos.com        99280   8-26-91   4:00
  2318.                    4dos.doc       345005   8-26-91   4:00
  2319.                    4dos.ico          766   8-26-91   4:00
  2320.  
  2321.  
  2322.           ___________________________________________________________________
  2323.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  33
  2324.  
  2325.                                             CHAPTER 3 / A GUIDED TOUR OF 4DOS
  2326.           ___________________________________________________________________
  2327.  
  2328.  
  2329.                    4dos.pif          545   8-26-91   4:00
  2330.                     ... ... ...
  2331.                    tour2.btm        2765   8-26-91   4:00
  2332.                    update40.doc    37946   8-26-91   4:00
  2333.                    vendor.doc       4434   8-26-91   4:00
  2334.                         835,038 bytes in 24 file(s)  858,112 bytes allocated
  2335.                      18,599,936 bytes free
  2336.  
  2337.               Once you've defined an alias, you can use it anywhere a
  2338.               command can be used: at the command prompt, in a batch file,
  2339.               or inside another alias.
  2340.  
  2341.               As an example, build on the D alias you have already defined.
  2342.               Suppose you regularly use 4DOS's 2-column directory listings,
  2343.               discussed near the start of the tour.  Each time you want a
  2344.               directory listing, you use the command DIR /2.  Define an
  2345.               alias, D2, to let you execute this command with the touch of a
  2346.               couple of keys.  Since you have already defined D, you can
  2347.               define D2 in either of these ways (choose one to try):
  2348.  
  2349.                    c:\4dos> alias d2 = dir /2
  2350.                    c:\4dos> alias d2 = d /2
  2351.  
  2352.               If you want to see the results, just enter ALIAS again:
  2353.  
  2354.                    c:\4dos> alias
  2355.                    d=dir
  2356.                    d2=d /2
  2357.  
  2358.               To use this alias, just enter the command D2 and press Enter.
  2359.               You can pass file names to these aliases just like you would
  2360.               to the original command.  For example, D2 *.DOC will give you
  2361.               a 2-column display of the .DOC files.
  2362.  
  2363.               You can create aliases that are even easier to use with 4DOS's
  2364.               keystroke aliases.  These aliases let you assign an Alt or
  2365.               Function key to an alias so you can invoke it by pressing a
  2366.               single key.  Say you'd like to assign the 2-column directory
  2367.               display to F5.  Just define an alias like D2 above, and make
  2368.               the alias name the key name, with an at-sign [@] before it:
  2369.  
  2370.                    c:\4dos> alias @f5 = dir /2
  2371.  
  2372.               Now press F5 and the DIR /2 command will appear on the command
  2373.               line.  Press Enter to execute it, or type some additional
  2374.               arguments and then press Enter if you'd like.  (You can also
  2375.               make key aliases execute as soon as you press the key.  For
  2376.               details on how, see the ALIAS command on page 173.)
  2377.  
  2378.  
  2379.           ___________________________________________________________________
  2380.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  34
  2381.  
  2382.                                             CHAPTER 3 / A GUIDED TOUR OF 4DOS
  2383.           ___________________________________________________________________
  2384.  
  2385.  
  2386.               You can use an alias to redefine how a standard command works,
  2387.               without changing its name.  Suppose you always want DIR to
  2388.               display its output in 2 columns, with a vertical sort and a
  2389.               pause at the end of each page.  You might think of using
  2390.               something like this:
  2391.  
  2392.                    c:\4dos> alias dir = dir /2/p/v
  2393.  
  2394.               Go ahead and try that, then do a DIR.  You'll get an error:
  2395.  
  2396.                    c:\4dos> dir
  2397.                    Alias loop
  2398.                    c:\4dos>
  2399.  
  2400.               The "alias loop" error is caused because 4DOS tries to
  2401.               reinterpret the DIR command inside your alias as another
  2402.               attempt to run the same alias.  It's easy to change the alias
  2403.               so this doesn't happen:
  2404.  
  2405.                    c:\4dos> alias dir = *dir /2/p/v
  2406.  
  2407.               The [*] tells 4DOS that what follows is not an alias.  Try the
  2408.               definition above (you can scroll back to the incorrect
  2409.               definition with up-arrow and modify it).  Then do a DIR and
  2410.               you'll see the results.  Using this method, you can redefine
  2411.               the default options for any 4DOS command.
  2412.  
  2413.               Aliases can contain multiple commands and can do much fancier
  2414.               things than what you've seen here.  They're great for creating
  2415.               shorthand names for commonly used programs like your word
  2416.               processor or database, and they will often help get programs
  2417.               loaded faster as well -- if you put the full name of the
  2418.               program in an alias, 4DOS doesn't have to search your PATH for
  2419.               it.
  2420.  
  2421.               For complete details, see the overview of aliases beginning on
  2422.               page 96, and the ALIAS command reference on page 173.
  2423.  
  2424.               When you read about aliases in the rest of the manual, you'll
  2425.               notice that most alias definitions are shown with back-quotes
  2426.               [`] around the part after the name.  Some aliases require
  2427.               these back-quotes when they are defined at the command line or
  2428.               in a batch file, to make it clear to 4DOS what is and isn't
  2429.               part of the alias.
  2430.  
  2431.               We show aliases that way elsewhere because it's the safest way
  2432.               to enter them at the command line.  If you always use the
  2433.               back-quotes, you don't have to worry about whether a
  2434.  
  2435.  
  2436.           ___________________________________________________________________
  2437.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  35
  2438.  
  2439.                                             CHAPTER 3 / A GUIDED TOUR OF 4DOS
  2440.           ___________________________________________________________________
  2441.  
  2442.  
  2443.               particular alias needs them or not.  We didn't use them here
  2444.               because none of these aliases require back quotes and we
  2445.               didn't want to add extra typing during the tour.
  2446.  
  2447.  
  2448.           Other Commands
  2449.  
  2450.               There are a few other commands that we'll just touch on, so
  2451.               that you can see some of 4DOS's other capabilities.
  2452.  
  2453.               First, turn on the 4DOS LOG facility, which records all the
  2454.               commands you enter in a file.  Enter the command:
  2455.  
  2456.                    c:\4dos> log /w mylog
  2457.  
  2458.               You won't see anything else happen, but you've turned logging
  2459.               on.  We'll return to the 4DOS log later.
  2460.  
  2461.               4DOS has a couple of commands that let you control screen
  2462.               color.  The examples here will work on any system with a color
  2463.               video board (the commands work on monochrome systems, too, but
  2464.               you're restricted to the colors white and black).  Try
  2465.               clearing the screen to a specific color:
  2466.  
  2467.                    c:\4dos> cls bright white on magenta
  2468.  
  2469.               Now let's set a different color:
  2470.  
  2471.                    c:\4dos> color bright yellow on blue
  2472.  
  2473.               The behavior of the COLOR command varies, depending on whether
  2474.               you have an ANSI driver loaded.  If you don't, COLOR will
  2475.               change the color of the entire screen immediately.  If you do
  2476.               have an ANSI driver loaded, COLOR only affects the color of
  2477.               text displayed after it's executed, and not the color of text
  2478.               already on the screen.  If you don't know, don't worry about
  2479.               it -- just experiment with COLOR and see.
  2480.  
  2481.               The FREE and MEMORY commands help you keep track of system
  2482.               resources.  FREE tells you about free space on your disk
  2483.               drives (and is much faster than CHKDSK).  MEMORY tells you
  2484.               about memory resources, including expanded and extended memory
  2485.               and 4DOS's internal alias and history storage areas.  Here are
  2486.               examples of the output from our test system; try the commands
  2487.               on your system and see what values you get.
  2488.  
  2489.                    c:\4dos> free
  2490.                     Volume in drive C is JPS_TEST    Serial number is ...
  2491.  
  2492.  
  2493.           ___________________________________________________________________
  2494.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  36
  2495.  
  2496.                                             CHAPTER 3 / A GUIDED TOUR OF 4DOS
  2497.           ___________________________________________________________________
  2498.  
  2499.  
  2500.                      41,826,304 bytes total disk space
  2501.                      23,232,512 bytes used
  2502.                      18,593,792 bytes free
  2503.  
  2504.                    c:\4dos> memory
  2505.                         655,360 bytes total DOS RAM
  2506.                         612,256 bytes free
  2507.  
  2508.                       7,815,168 bytes total EMS memory
  2509.                         688,128 bytes free
  2510.  
  2511.                          12,288 bytes free XMS memory  (HMA in use)
  2512.  
  2513.                           1,792 bytes total environment
  2514.                             233 bytes free
  2515.  
  2516.                           6,144 bytes total alias
  2517.                           1,045 bytes free
  2518.  
  2519.                           1,024 bytes total history
  2520.  
  2521.               The TIMER command lets you time events.  The following line
  2522.               also shows 4DOS's ability to accept multiple commands on one
  2523.               line, separated by a caret [^].  It starts the timer, runs the
  2524.               TOUR2.BTM file to create the three demonstration files,
  2525.               deletes the three files, and then stops the timer and displays
  2526.               the time the whole operation took.  Enter this command to time
  2527.               the entire sequence on your computer:
  2528.  
  2529.                    c:\4dos> timer ^ tour2 ^ del file1 file2 file3 ^ timer
  2530.                    Timer 1 on: 11:10:01
  2531.  
  2532.                    Please wait ...
  2533.  
  2534.                    File creation completed
  2535.                    Deleting c:\4dos\file1
  2536.                    Deleting c:\4dos\file2
  2537.                    Deleting c:\4dos\file3
  2538.                         3 file(s) deleted
  2539.                    Timer 1 off: 11:10:06 elapsed: 0:00:05.11
  2540.  
  2541.               Now return to the log that you started a few minutes ago.
  2542.               Turn logging off, then take a look at what was recorded.
  2543.               Enter the following two commands;  the output will pause at
  2544.               the end of each page:
  2545.  
  2546.                    c:\4dos> log off
  2547.                    c:\4dos> type mylog /p
  2548.  
  2549.  
  2550.           ___________________________________________________________________
  2551.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  37
  2552.  
  2553.                                             CHAPTER 3 / A GUIDED TOUR OF 4DOS
  2554.           ___________________________________________________________________
  2555.  
  2556.  
  2557.                    [ 8-22-91 11:05:02] cls bright white on magenta
  2558.                    [ 8-22-91 11:05:54] color bright yellow on blue
  2559.                    [ 8-22-91 11:07:08] free
  2560.                    [ 8-22-91 11:07:49] memory
  2561.                    [ 8-22-91 11:09:55] timer
  2562.                    [ 8-22-91 11:09:56] tour2
  2563.                      ... (commands from TOUR2.BTM will be displayed here)
  2564.                    [ 8-22-91 11:10:00] del file1 file2 file3
  2565.                    [ 8-22-91 11:10:01] timer
  2566.                    [ 8-22-91 11:12:35] log off
  2567.  
  2568.               As you can see, the log contains every command you entered
  2569.               plus a date and time stamp.  It's a complete record of system
  2570.               activity, including commands you type and those entered from
  2571.               batch files and aliases.  You can use it as a record of your
  2572.               work, for security purposes, or for anything else you desire.
  2573.               You may want to clean up the directory now by deleting this
  2574.               demonstration log with a DEL MYLOG command.
  2575.  
  2576.  
  2577.           Batch Programming
  2578.  
  2579.               This final section demonstrates a very little bit of what 4DOS
  2580.               can do for your batch files.  If you've never worked with
  2581.               batch files, you may want to skip this section.  If you aren't
  2582.               sure, give it a try and stop if things seem too complex.  You
  2583.               don't have to be a batch file programmer to use 4DOS.
  2584.  
  2585.               Rather than having you go to the trouble of writing actual
  2586.               batch files, we'll demonstrate some of the parts of 4DOS's
  2587.               batch file power that work just as well at the prompt.
  2588.  
  2589.               Some 4DOS batch file improvements aid in communicating with
  2590.               the user.  You can make sounds:
  2591.  
  2592.                    c:\4dos> beep 440 2 880 8 660 4
  2593.  
  2594.               You can draw boxes and lines.  Enter each of these commands on
  2595.               one line; use the second set of commands if you have a
  2596.               monochrome monitor:
  2597.  
  2598.                    c:\4dos> cls bright white on blue
  2599.                    c:\4dos> drawbox 10 10 20 70 4 bright cyan on black fill
  2600.                              black
  2601.                    c:\4dos> drawhline 15 10 61 1 bright cyan on black
  2602.  
  2603.                    c:\4dos> cls bright white on black
  2604.                    c:\4dos> drawbox 10 10 20 70 4 black on white fill white
  2605.  
  2606.  
  2607.           ___________________________________________________________________
  2608.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  38
  2609.  
  2610.                                             CHAPTER 3 / A GUIDED TOUR OF 4DOS
  2611.           ___________________________________________________________________
  2612.  
  2613.  
  2614.                    c:\4dos> drawhline 15 10 61 1 black on white
  2615.  
  2616.               Notice that 4DOS correctly connects the line to the box where
  2617.               they intersect.  4DOS has additional commands like SCREEN and
  2618.               SCRPUT, which we won't demonstrate here, to display text
  2619.               anywhere on the screen and in any color.
  2620.  
  2621.               4DOS also helps you ask the user for input.  Try this (be sure
  2622.               to use two percent signs before the second "letter"):
  2623.  
  2624.                    c:\4dos> inkey Enter a letter: %%letter
  2625.                    Enter a letter: A
  2626.  
  2627.               The letter you typed was stored in your environment in the
  2628.               variable named LETTER.  Use the SET command to view it:
  2629.  
  2630.                    c:\4dos> set
  2631.                    COMSPEC=C:\4DOS\4DOS.COM
  2632.                     ... ... ...
  2633.                    LETTER=A
  2634.  
  2635.               The user can also type full strings if you use the INPUT
  2636.               command:
  2637.  
  2638.                    c:\4dos> input Enter a string: %%string
  2639.                    Enter a string: Type anything you like here ...
  2640.  
  2641.               Again, SET will let you view the string, stored in the
  2642.               environment variable STRING.
  2643.  
  2644.               Once you've collected some input, you will probably want to
  2645.               test it with the 4DOS IF and IFF commands.  Here's one
  2646.               example.  Enter this on one line (there's plenty of room;
  2647.               4DOS command lines can be up to 255 characters long).  Note
  2648.               that two percent signs are used in the INKEY command and one
  2649.               is used in the IFF, and that a double equal sign is used in
  2650.               the IFF statement.
  2651.  
  2652.                    c:\4dos> inkey Enter a letter: %%letter ^
  2653.                             iff "%letter"=="A" then ^ echo hi ^ else ^
  2654.                             echo bye ^ endiff
  2655.  
  2656.               Try using the up-arrow to repeat the command several times,
  2657.               giving different responses to the "Enter a letter" prompt.
  2658.  
  2659.               4DOS offers dozens of additional batch file improvements.  For
  2660.               more information see the section on batch files beginning on
  2661.               page 99, and the reference for each individual command.
  2662.  
  2663.  
  2664.           ___________________________________________________________________
  2665.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  39
  2666.  
  2667.                                             CHAPTER 3 / A GUIDED TOUR OF 4DOS
  2668.           ___________________________________________________________________
  2669.  
  2670.  
  2671.           Conclusion
  2672.  
  2673.               This has been a very fast tour of some of the most popular
  2674.               features of 4DOS.  There are many more features, commands and
  2675.               options to explore, as well as ways to customize 4DOS so that
  2676.               it suits your computing habits and needs.  One of 4DOS's best
  2677.               features is its ability to adapt to your way of working
  2678.               instead of requiring you to adapt to it.
  2679.  
  2680.               If you selected "Tour Installation" when you ran the 4DOS
  2681.               INSTALL program, you will probably want to perform a full
  2682.               installation now.  You can put the 4DOS disk in your floppy
  2683.               drive, run INSTALL, and follow the instructions on the screen.
  2684.               If you need help, refer to the installation instructions on
  2685.               page 13.
  2686.  
  2687.               To learn more about specific 4DOS commands, look through the
  2688.               Command Reference section of this manual, beginning on page
  2689.               166.  To learn more about the dozens of 4DOS features that
  2690.               aren't related to specific commands, read through Chapter 5 /
  2691.               Using 4DOS, beginning on page 54.
  2692.  
  2693.  
  2694.  
  2695.  
  2696.  
  2697.  
  2698.  
  2699.  
  2700.  
  2701.  
  2702.  
  2703.  
  2704.  
  2705.  
  2706.  
  2707.  
  2708.  
  2709.  
  2710.  
  2711.  
  2712.  
  2713.  
  2714.  
  2715.  
  2716.  
  2717.  
  2718.  
  2719.  
  2720.  
  2721.           ___________________________________________________________________
  2722.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  40
  2723.  
  2724.                                                  CHAPTER 4 / GENERAL CONCEPTS
  2725.           ___________________________________________________________________
  2726.  
  2727.  
  2728.  
  2729.           CHAPTER 4 / GENERAL CONCEPTS
  2730.  
  2731.  
  2732.           You can start using 4DOS as soon as you finish installing it,
  2733.           because 4DOS is compatible with the traditional commands you're
  2734.           used to.  But most users find that the more they know about their
  2735.           computer systems, the more power they get from 4DOS.  And, the more
  2736.           experienced they become with 4DOS, the more they want to know about
  2737.           their computer system as a whole.
  2738.  
  2739.           This section of the manual explains some fundamental concepts about
  2740.           your computer, DOS, and 4DOS.  It should help you understand the
  2741.           terms and concepts in the pages that follow.  If you find some of
  2742.           the concepts overwhelming, just remember that they are here when
  2743.           you need them.  If you find this material too simple, skim over the
  2744.           topics and then go on to the next section.  Each topic in this
  2745.           chapter is independent, so if you read it straight through you
  2746.           won't necessarily find a natural "flow" from one topic to another.
  2747.  
  2748.           If you come across terms or concepts in this chapter that you are
  2749.           unsure about, refer to the Glossary on page 355 or the Index.
  2750.  
  2751.  
  2752.           DOS and the Command Interpreter
  2753.  
  2754.               When you turn on your computer, it first runs some internal
  2755.               diagnostics and then looks for a boot disk, either a floppy
  2756.               disk in drive A or your hard disk.  There is nothing magical
  2757.               about a boot disk;  it simply has a copy of DOS and a command
  2758.               interpreter available, plus a small block of special
  2759.               information that tells the computer that it is indeed a boot
  2760.               disk.
  2761.  
  2762.               The core portion of DOS consists of two hidden files (files
  2763.               that are normally invisible to the DIR command).  They aren't
  2764.               hidden to keep you from copying or examining them, but rather
  2765.               to keep you from accidentally erasing them.  The names of the
  2766.               files depend on the version of DOS you are using, but they are
  2767.               usually something like MSDOS.SYS and IO.SYS.  These two files
  2768.               contain the operating system, which controls your disk files
  2769.               and directories, loads and runs programs, maintains the system
  2770.               time and date, and performs other housekeeping tasks.
  2771.  
  2772.               After the computer loads DOS into memory, it performs some
  2773.               standard initialization tasks and then looks for a file called
  2774.               CONFIG.SYS, which contains user-specified initialization
  2775.               commands.  You can view and edit your CONFIG.SYS file with any
  2776.  
  2777.  
  2778.           ___________________________________________________________________
  2779.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  41
  2780.  
  2781.                                                  CHAPTER 4 / GENERAL CONCEPTS
  2782.           ___________________________________________________________________
  2783.  
  2784.  
  2785.               text editor.  One of the optional lines in CONFIG.SYS begins
  2786.               with the word SHELL.  That line names the command interpreter
  2787.               that DOS should load as it completes its initialization.
  2788.  
  2789.               A command interpreter is a program that accepts your
  2790.               instructions and carries them out.  The command interpreter
  2791.               shipped with DOS is called COMMAND.COM.  Once you have 4DOS
  2792.               installed, 4DOS.COM replaces COMMAND.COM as your command
  2793.               interpreter.  Both COMMAND.COM and 4DOS are normal programs
  2794.               that know how to translate your commands into actions.  4DOS
  2795.               is simply a much more powerful command interpreter than
  2796.               COMMAND.COM.
  2797.  
  2798.  
  2799.               Primary and Secondary Shells
  2800.  
  2801.               Technically, the command interpreter is a shell:  a program
  2802.               that understands your commands and makes the correct calls to
  2803.               DOS to perform various operations, including running programs.
  2804.  
  2805.               The command interpreter that runs when the computer boots up
  2806.               is called the primary shell.  Any command interpreter that is
  2807.               run by an application program with a "shell to DOS" feature,
  2808.               or that is run by a multitasking program like Windows or
  2809.               DESQview, is a secondary shell.  4DOS can be run as a primary
  2810.               shell and as a secondary shell.
  2811.  
  2812.               A secondary shell has all the same features as a primary
  2813.               shell, but you can leave a secondary shell with the EXIT
  2814.               command.  There is no way to exit from the primary shell,
  2815.               because your computer needs a shell present to operate.  (You
  2816.               can exit from the primary shell in one special case:  if
  2817.               you're running in a DOS session under OS/2 version 2.)
  2818.  
  2819.               There are only a few differences between primary and secondary
  2820.               shells.  Generally, less memory is available when a secondary
  2821.               shell is running, because at least part of the program that
  2822.               started it is still in memory waiting to spring back to life
  2823.               when you exit.  And normally only the primary shell
  2824.               automatically executes the instructions in your AUTOEXEC.BAT
  2825.               file.
  2826.  
  2827.               You may also see the term shell used to describe programs
  2828.               which assist you in managing your files (for example XTree or
  2829.               Lotus Magellan).  This is a different and less precise meaning
  2830.               of "shell" than the one used above and elsewhere in this
  2831.               manual.  Such programs are also sometimes called "visual
  2832.               shells" because they use a menu or graphical interface to
  2833.  
  2834.  
  2835.           ___________________________________________________________________
  2836.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  42
  2837.  
  2838.                                                  CHAPTER 4 / GENERAL CONCEPTS
  2839.           ___________________________________________________________________
  2840.  
  2841.  
  2842.               receive commands.  Unlike 4DOS, these programs are not command
  2843.               interpreters, and cannot replace COMMAND.COM.
  2844.  
  2845.  
  2846.               AUTOEXEC.BAT, 4START, and 4EXIT
  2847.  
  2848.               When a primary shell, either COMMAND.COM or 4DOS, gets control
  2849.               from DOS during boot up, one of its first responsibilities is
  2850.               to look for and run a batch file called AUTOEXEC.BAT, if that
  2851.               file is available in the root directory of the boot drive.
  2852.               This file is simply a list of commands that you want to have
  2853.               executed every time your computer boots up.  If COMMAND.COM
  2854.               cannot find AUTOEXEC.BAT, it asks you for the time and date.
  2855.               4DOS skips that step and immediately displays a standard
  2856.               prompt (e.g., c:\>).
  2857.  
  2858.               Every time 4DOS starts as either a primary or secondary shell,
  2859.               it also looks for an optional batch file called 4START.BTM or
  2860.               4START.BAT, and runs the file if it finds it.  4START is a
  2861.               convenient place to put special 4DOS configuration commands.
  2862.  
  2863.               Whenever you exit from a 4DOS secondary shell, 4DOS looks for
  2864.               another optional file called 4EXIT.BTM or 4EXIT.BAT and runs
  2865.               the file if it finds it.  4EXIT is not necessary in most
  2866.               circumstances, but is a convenient place to put commands to
  2867.               save information from a secondary shell before it exits.
  2868.  
  2869.               AUTOEXEC.BAT, 4START, and 4EXIT are called automatic batch
  2870.               files because they run without your intervention at specific
  2871.               times.  4START and 4EXIT should not be used to load any memory
  2872.               resident programs (TSRs).  Otherwise, these three files can
  2873.               include any commands that could be part of any batch file or
  2874.               any commands which you could type from the command line.
  2875.  
  2876.               For more details about batch files and batch file commands,
  2877.               see pages 99 and 167.
  2878.  
  2879.  
  2880.           Command Processing
  2881.  
  2882.               Whenever you type something at the command line and press the
  2883.               Enter key, you have given a command to 4DOS, which must figure
  2884.               out how to execute your command.  If you understand the
  2885.               general process that 4DOS uses, you will be able to make the
  2886.               best use of the 4DOS commands.
  2887.  
  2888.               4DOS begins by dividing the line you typed into an action word
  2889.               and a command tail.  The action word is the first word in the
  2890.  
  2891.  
  2892.           ___________________________________________________________________
  2893.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  43
  2894.  
  2895.                                                  CHAPTER 4 / GENERAL CONCEPTS
  2896.           ___________________________________________________________________
  2897.  
  2898.  
  2899.               command;  the tail is everything that follows the command
  2900.               word.  For example, in the command line
  2901.  
  2902.                    dir *.txt /p/o/n
  2903.  
  2904.               the action word is "dir," and the command tail is "*.txt
  2905.               /p/o/n."
  2906.  
  2907.               To decide what activity to perform, 4DOS makes five attempts
  2908.               to understand the action word:
  2909.  
  2910.               First, 4DOS tries to match the action word against its
  2911.               internal list of aliases, which are synonyms that you have
  2912.               defined for commands.  If it finds a match between the action
  2913.               word you typed and one of the aliases you've defined, it
  2914.               replaces the action word you typed with the action word from
  2915.               the alias.  (This substitution is done internally, and is not
  2916.               normally visible to you).  Once it has finished with the
  2917.               aliases, 4DOS continues with the steps listed below to
  2918.               identify the meaning of the new action word.
  2919.  
  2920.                    4DOS first tries to match the action word against its
  2921.                    list of more than 80 internal commands, which are actions
  2922.                    that are built into 4DOS.  If it finds a match, 4DOS
  2923.                    performs the internal command and then waits for a new
  2924.                    instruction from you.
  2925.  
  2926.                    If there is no match with any of 4DOS's internal
  2927.                    commands, it looks for an executable file (one with a
  2928.                    .COM or .EXE extension) whose name matches the action
  2929.                    word.  It runs the executable file if it finds one.  This
  2930.                    is called an external command or external program.
  2931.  
  2932.                    Next, 4DOS looks for a batch file (with a .BTM or .BAT
  2933.                    extension) that matches the action word.  If it finds
  2934.                    such a file, it then reads each line in the file as a new
  2935.                    command.
  2936.  
  2937.                    Finally, 4DOS checks to see if the action word matches
  2938.                    the name of a file with an extension that you have
  2939.                    defined as executable.  If a match is found, 4DOS runs
  2940.                    the program you specified when you defined the executable
  2941.                    extension.  (Executable extensions are used to associate
  2942.                    file extensions with the specific program that processes
  2943.                    a particular type of file; see page 76 for details).
  2944.  
  2945.               4DOS first tries the last three steps in the current
  2946.               directory.  If the action word doesn't match a .COM, .EXE,
  2947.  
  2948.  
  2949.           ___________________________________________________________________
  2950.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  44
  2951.  
  2952.                                                  CHAPTER 4 / GENERAL CONCEPTS
  2953.           ___________________________________________________________________
  2954.  
  2955.  
  2956.               .BTM, or .BAT file or an executable extension in the current
  2957.               directory, 4DOS repeats its search in every directory in your
  2958.               PATH.  The PATH is a list of directories that 4DOS (and some
  2959.               applications) search to look for executable files.  If all
  2960.               these searches fail, 4DOS displays an "Unknown command" error
  2961.               message and waits for your next instruction.
  2962.  
  2963.               If 4DOS finds a matching internal command in the first step,
  2964.               that command begins its activity by examining the command
  2965.               tail.  Some commands require information in the command tail,
  2966.               some accept optional information, and others don't allow any
  2967.               command tail at all.  The command tail for internal commands
  2968.               usually contains filenames, directory names, option switches
  2969.               which modify the command's behavior, or other information.
  2970.  
  2971.               4DOS makes the command tail available to every alias, batch
  2972.               file, and external command that it executes.  Aliases and
  2973.               batch files can examine the command tail by using "replaceable
  2974.               parameters," (see page 100).  External commands examine the
  2975.               command tail in a manner determined by the programmer who
  2976.               wrote that particular external program.
  2977.  
  2978.               It is up to each command to examine the command tail to make
  2979.               sure that the information it has received makes sense.  If you
  2980.               use an option switch which the command doesn't understand, or
  2981.               if you omit a required piece of information, the command
  2982.               issues an error message and ends.  Therefore, the command
  2983.               lines that you create must fit the format that each alias,
  2984.               internal or external command, or batch file expects.
  2985.  
  2986.               The process that internal and external commands go through to
  2987.               separate the individual elements of the command line, make
  2988.               sure you used the correct syntax, and understand what you have
  2989.               requested, is called parsing.
  2990.  
  2991.  
  2992.           Files and Paths
  2993.  
  2994.               You may have dozens, hundreds, or thousands of files stored on
  2995.               your computer's disks.  DOS is responsible for managing all of
  2996.               these files.  In order to do so, it uses a unique name to
  2997.               locate each file in much the same way that the post office
  2998.               assigns a unique address to every residence.
  2999.  
  3000.               The unique name of any file is composed of a drive letter, a
  3001.               directory path, and a filename.  Each of these parts of the
  3002.               file's name is case insensitive;  you can mix upper and lower
  3003.               case letters in any way you wish.
  3004.  
  3005.  
  3006.           ___________________________________________________________________
  3007.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  45
  3008.  
  3009.                                                  CHAPTER 4 / GENERAL CONCEPTS
  3010.           ___________________________________________________________________
  3011.  
  3012.  
  3013.               A drive letter designates which drive contains the file.  In a
  3014.               file's full name, the drive letter is followed by a colon.
  3015.               Drive letters A: and B: are normally reserved for the floppy
  3016.               disk drives.  (Systems with a single drive use both A: and B:
  3017.               for that drive.  DOS asks you to swap diskettes as necessary
  3018.               to turn that single physical drive into two separate logical
  3019.               disk drives.)
  3020.  
  3021.               Normally, drive C: is the first (or only) hard disk drive.
  3022.               Later versions of DOS and some utility programs can divide a
  3023.               large hard disk into multiple logical drives that are usually
  3024.               called C:, D:, E:, etc.  Also, the DOS utility SUBST lets you
  3025.               use drive letters as a substitute for directory names.  Many
  3026.               network systems (LANs) use a similar feature to give drive
  3027.               letters to sections of the network file server drives.
  3028.  
  3029.               Some computers also have "RAM disks", which are areas of
  3030.               memory set aside by software (a "RAM disk driver") for use as
  3031.               fast, but temporary storage.  RAM disks are also assigned
  3032.               drive letters, typically using letters beyond that used by the
  3033.               last hard disk in the system, but before any network drives.
  3034.               For example, on a system with a large hard disk you might have
  3035.               A: and B: as floppy drives, C:, D:, and E: as parts of the
  3036.               hard disk, F: as a RAM disk, and G: and H: as network drives.
  3037.  
  3038.               Directories are used to divide the files on a drive into
  3039.               logical groups that are easy to work with.  Their purpose is
  3040.               similar to the use of file drawers to contain groups of
  3041.               hanging folders, hanging folders to contain smaller manila
  3042.               folders, and so on.
  3043.  
  3044.               Every drive has a root or base directory, and many have one or
  3045.               more subdirectories.  Subdirectories can also have
  3046.               subdirectories, extending in a branching tree structure from
  3047.               the root directory.  The collection of all directories on a
  3048.               drive is often called the directory tree, and a portion of the
  3049.               tree is sometimes called a subtree.  The terms directory and
  3050.               subdirectory are typically used interchangeably to mean a
  3051.               single subdirectory within this tree structure.
  3052.  
  3053.               Subdirectory names follow the same naming rules as files (see
  3054.               below): a base name followed by an optional extension.
  3055.               However, some application programs do not properly handle
  3056.               subdirectory names that have an extension.  It is best to use
  3057.               only an 8 character (or less) name, without an extension, for
  3058.               subdirectories.
  3059.  
  3060.  
  3061.  
  3062.  
  3063.           ___________________________________________________________________
  3064.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  46
  3065.  
  3066.                                                  CHAPTER 4 / GENERAL CONCEPTS
  3067.           ___________________________________________________________________
  3068.  
  3069.  
  3070.               The drive and subdirectory portion of a file's name are
  3071.               collectively called the file's path.  For example, the file
  3072.               name C:\DIR1\DIR2\MYFILE.DAT says to look for the file
  3073.               MYFILE.DAT in the subdirectory DIR2 which is part of the
  3074.               subdirectory DIR1 which is on drive C.  The path for
  3075.               MYFILE.DAT is C:\DIR1\DIR2.  The backslashes between
  3076.               subdirectory names are required.  The total length of a file's
  3077.               path may not exceed 64 characters (excluding the file name and
  3078.               extension, but including the drive letter and colon).
  3079.  
  3080.               DOS remembers both a current or default drive for your system
  3081.               as a whole, and a current or default directory for every drive
  3082.               in your system.  Whenever a program tries to create or access
  3083.               a file without specifying the file's path, DOS uses the
  3084.               current drive (if no other drive is specified) and the current
  3085.               directory (if no other directory path is specified).
  3086.  
  3087.               The root directory is named using the drive letter and a
  3088.               single backslash.  For example, D:\ refers to the root
  3089.               directory of drive D:.  Using a drive letter with no directory
  3090.               name at all refers to the current directory on the specified
  3091.               drive.  For example, E:4DOS.DOC refers to the file 4DOS.DOC in
  3092.               the current directory on drive E:.
  3093.  
  3094.               There are also two special subdirectory names that are useful
  3095.               in many situations: a single period [.] by itself means "the
  3096.               current default directory."  Two periods together [..] means
  3097.               "the directory which contains the current default directory"
  3098.               (often referred to as the parent directory).  These special
  3099.               names can be used wherever a full directory name can be used.
  3100.               4DOS allows you to use additional periods to specify
  3101.               directories further "up" the tree (see page 189).
  3102.  
  3103.               Finally, each file has a filename.  The filename consists of a
  3104.               base name of 1 to 8 characters plus an optional extension
  3105.               composed of a period plus 1 to 3 more characters.  You can use
  3106.               alphabetic and numeric characters plus the punctuation marks !
  3107.               # $ % & ' ( ) - @ ^ _ ` { } and ~ in both the base name and
  3108.               the extension.  Because the exclamation point [!], percent
  3109.               sign [%], caret [^], at-sign [@], parentheses [()], and back-
  3110.               quote [`] also have other meanings to 4DOS, it is best to
  3111.               avoid using them in filenames.
  3112.  
  3113.               Each file also has attributes which define characteristics of
  3114.               the file which may be useful to DOS, to you, or to an
  3115.               application program.  Attributes can be set with 4DOS's ATTRIB
  3116.               command (see page 182) and viewed with the ATTRIB and DIR
  3117.               commands.  Every time a program modifies a file, DOS sets the
  3118.  
  3119.  
  3120.           ___________________________________________________________________
  3121.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  47
  3122.  
  3123.                                                  CHAPTER 4 / GENERAL CONCEPTS
  3124.           ___________________________________________________________________
  3125.  
  3126.  
  3127.               Archive attribute, which signals that the file has been
  3128.               modified since it was last backed up.  This can be used by
  3129.               4DOS to determine which files to COPY, and by backup programs
  3130.               to determine which files to back up.  When the Read-only
  3131.               attribute is set, the file can't be changed or erased; this
  3132.               can be used to protect important files from damage.  The
  3133.               Hidden and System attributes prevent the file from appearing
  3134.               in normal directory listings.  The 4DOS DIR command (see page
  3135.               210) has options which allow you to select filenames to view
  3136.               based on their attributes, to view the attributes themselves,
  3137.               and to view information about normally "invisible" hidden and
  3138.               system files.
  3139.  
  3140.               When a file is created, and every time it is modified, DOS
  3141.               records the system time and date in a time stamp in the file's
  3142.               directory entry.  Several 4DOS commands and variable
  3143.               functions, and many backup and utility programs, use this time
  3144.               stamp to determine the relative ages of files.
  3145.  
  3146.  
  3147.           The Environment
  3148.  
  3149.               The command interpreter keeps a list of information about your
  3150.               computer in memory.  This list is called the environment.
  3151.               Every program receives a copy of the environment when it
  3152.               begins, and many programs use some of its information to
  3153.               configure themselves or to find files.
  3154.  
  3155.               The environment is arranged as a series of variables and their
  3156.               related values.  Each variable is a name stored in upper case.
  3157.               The name is followed by an equal sign [=] and some text.  You
  3158.               can view the environment with the SET command, and add new
  3159.               entries or edit existing entries with SET and ESET.  A typical
  3160.               environment entry looks like this:
  3161.  
  3162.                LIB=c:\lib
  3163.  
  3164.               In this example, the name of the variable is LIB and its value
  3165.               is "c:\lib."
  3166.  
  3167.               The format and meaning of each entry in the environment is up
  3168.               to the program that uses the particular variable.  Environment
  3169.               variables can contain just about anything, and can be used for
  3170.               any purpose the author of a program desires.  The "purpose" of
  3171.               the environment as a whole is simply to hold small amounts of
  3172.               text which programs can then access according to their own
  3173.               rules.  Most environment variables are used by single programs
  3174.  
  3175.  
  3176.  
  3177.           ___________________________________________________________________
  3178.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  48
  3179.  
  3180.                                                  CHAPTER 4 / GENERAL CONCEPTS
  3181.           ___________________________________________________________________
  3182.  
  3183.  
  3184.               for their own information;  a few have well-defined meanings
  3185.               and are used by many different programs.
  3186.  
  3187.               One of the most important environment variables is called
  3188.               PATH.  The text of PATH is a list of subdirectories separated
  3189.               by semi-colons.  4DOS searches each of the subdirectories
  3190.               listed in the PATH entry to find executable files that aren't
  3191.               in the default directory.  Many programs also search the PATH
  3192.               list to find their own files.
  3193.  
  3194.               4DOS uses several environment variables to control its own
  3195.               behavior, and provides a wide range of facilities for
  3196.               manipulating and managing the environment.  See page 116 for
  3197.               additional details.
  3198.  
  3199.  
  3200.           Memory
  3201.  
  3202.               The memory in your computer is organized in bytes.  Normally,
  3203.               the amount of memory in a computer is discussed in terms of
  3204.               kilobytes (KBytes or 1,024 bytes) and megabytes (MBytes or
  3205.               1,048,576 bytes or 1,024 KBytes).  The amount of memory
  3206.               available in your computer is determined by the number of
  3207.               memory chips you have installed.
  3208.  
  3209.               In an ideal world, there would be little more to say about
  3210.               memory.  But because of the history of PCs, the needs of large
  3211.               application programs, and the capabilities of advanced CPUs,
  3212.               there are many different kinds of memory.  The original 8088
  3213.               CPUs of the PC and PC/XT can address 1 MByte of memory.  Of
  3214.               that, a maximum of 640KBytes is allocated as base,
  3215.               conventional, DOS, or low DOS memory (all these terms mean the
  3216.               same thing).  The other 384 KBytes, known as upper memory, are
  3217.               set aside for the computer's built-in ROM BIOS, video adapter
  3218.               cards, hard disk controllers, and other expansion hardware.
  3219.  
  3220.               When base memory became too limiting, expanded memory (or EMS
  3221.               memory) was developed to give programs more data space.
  3222.               Expanded memory adds up to 16 MBytes which programs can
  3223.               access, 64KBytes at a time, through a window in upper memory.
  3224.               In 8088 / 8086 (PC and XT), and 80286 (AT) based computers,
  3225.               expanded memory typically requires an add-on board and support
  3226.               software.  In 386 and 486 computers, expanded memory is
  3227.               typically provided without additional hardware, using the
  3228.               capabilities of the 386/486 chips.
  3229.  
  3230.               The 80286 CPU used in the AT, and modern 386 and 486 CPUs, can
  3231.               use much more than the 8088's original 1 MByte of memory.  An
  3232.  
  3233.  
  3234.           ___________________________________________________________________
  3235.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  49
  3236.  
  3237.                                                  CHAPTER 4 / GENERAL CONCEPTS
  3238.           ___________________________________________________________________
  3239.  
  3240.  
  3241.               80286 can use a total of 16 MBytes;  the 386 and 486 can use
  3242.               up to a whopping 4,096 MBytes.  This extended memory is not
  3243.               normally available to DOS-based programs, however, without
  3244.               special programming techniques and the help of DOS extenders
  3245.               or memory managers.
  3246.  
  3247.               The memory terms used in this manual include
  3248.  
  3249.                    BASE memory:  The 640 Kbytes or less that has
  3250.                    traditionally been available for DOS and DOS-based
  3251.                    applications.
  3252.  
  3253.                    EMS or LIM EMS Memory:  Memory which conforms to the
  3254.                    Expanded Memory Specification, developed by Lotus, Intel,
  3255.                    and Microsoft, that lets programs and utilities share
  3256.                    expanded memory.
  3257.  
  3258.                    Extended Memory:  Memory beyond 1 MB in 80286, 386, and
  3259.                    486 computers.  This memory may be accessed directly, in
  3260.                    which case it is referred to as Extended Memory, or
  3261.                    through XMS software, in which case it is referred to as
  3262.                    XMS Memory (see below).
  3263.  
  3264.                    XMS Memory:  Extended memory managed by software which
  3265.                    conforms to the Extended Memory Specification (XMS).  XMS
  3266.                    lets programs share extended memory without conflict.
  3267.                    This specification divides extended memory into extended
  3268.                    memory blocks (EMBs).  XMS software also usually manages
  3269.                    the HMA and the UMBs (see below).
  3270.  
  3271.                    HMA:  The first 64K bytes of extended memory, located
  3272.                    just above 1 MB.  Certain specialized programs such as
  3273.                    DESQview, some network drivers, and portions of MS-DOS
  3274.                    5.0 and DR-DOS 5.0 can be loaded into the HMA instead of
  3275.                    taking up valuable space in base memory.
  3276.  
  3277.                    UMBs:  386 and 486 computers can electronically move
  3278.                    pieces of extended memory into unused space in the upper
  3279.                    memory area between 640KB and 1 MB.  Each block of this
  3280.                    memory is called an Upper Memory Block (UMB).  With DOS
  3281.                    5.0 or special 386/486 memory managers, memory-resident
  3282.                    programs can be loaded into these UMBs instead of taking
  3283.                    up valuable space in base memory.  Some 8086, 8088, and
  3284.                    80286 systems can also use UMBs with appropriate
  3285.                    additional hardware and software (see page 144 for
  3286.                    details).
  3287.  
  3288.  
  3289.  
  3290.  
  3291.           ___________________________________________________________________
  3292.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  50
  3293.  
  3294.                                                  CHAPTER 4 / GENERAL CONCEPTS
  3295.           ___________________________________________________________________
  3296.  
  3297.  
  3298.           ASCII and Key Codes
  3299.  
  3300.               Internally, computers use numbers for everything.  To
  3301.               represent the text that you type, a computer must translate
  3302.               each letter to and from a number.  For all PC-compatible
  3303.               computers, the code used for this translation is called ASCII
  3304.               (American Standard Code for Information Interchange).  ASCII
  3305.               codes are used both for the characters you type and for the
  3306.               characters that are displayed on the screen.
  3307.  
  3308.               The original ASCII code has 128 values for upper and lower
  3309.               case letters, numerals, punctuation marks, and control codes.
  3310.               The control codes correspond to pressing the Ctrl key plus an
  3311.               alphabetic character.  Some control codes are also represented
  3312.               on the keyboard with such keys as Tab, Enter, Backspace, and
  3313.               Esc.  IBM, in its original PC, defined an additional 128
  3314.               extended ASCII codes for math symbols, international
  3315.               characters, the line characters used to draw boxes, and some
  3316.               miscellaneous symbols.  You can enter extended ASCII codes on
  3317.               the keyboard by holding down the Alt key while you type the
  3318.               code number on the numeric key pad.
  3319.  
  3320.               Do not confuse extended ASCII with extended key codes.  The
  3321.               latter include special codes that the computer generates when
  3322.               you press a function key, cursor key, or Alt plus a letter.
  3323.               Those keys do not have any representation in either the ASCII
  3324.               or extended ASCII code systems.  Another set of key codes,
  3325.               called scan codes, is discussed in the section on the keyboard
  3326.               below.
  3327.  
  3328.               Appendix B on page 338 has a complete list of ASCII, extended
  3329.               ASCII, and extended key codes.
  3330.  
  3331.  
  3332.           The Keyboard
  3333.  
  3334.               The original IBM PC, PC/XT, and virtually all XT-compatible
  3335.               computers use an 83-key keyboard with 10 function keys.  The
  3336.               earliest PC/AT computer and compatibles added an 84th key,
  3337.               called SysReq, but left the rest of the keyboard the same.
  3338.               Most 80286, 386, and 486 computers now use an "enhanced"
  3339.               keyboard with 101 or more keys, including 12 or more function
  3340.               keys.
  3341.  
  3342.               When you press a single key or a key combination, the computer
  3343.               translates the keystroke into two numbers.  For all
  3344.               alphabetic, numeric, and punctuation keys, the Tab, Enter,
  3345.               Backspace, Esc keys and Ctrl plus an alphabetic key, these
  3346.  
  3347.  
  3348.           ___________________________________________________________________
  3349.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  51
  3350.  
  3351.                                                  CHAPTER 4 / GENERAL CONCEPTS
  3352.           ___________________________________________________________________
  3353.  
  3354.  
  3355.               numbers are an ASCII code plus a scan code.  The ASCII code
  3356.               represents the key's meaning; the scan code identifies which
  3357.               specific key was pressed.  For example, many keyboards have
  3358.               two plus [+] keys, one above the equal sign and one on the
  3359.               numeric keypad.  Both generate the same ASCII code, but they
  3360.               generate different scan codes.
  3361.  
  3362.               Keys which are not represented by ASCII codes are translated
  3363.               to an ASCII 0 plus an extended key code.  These keys include
  3364.               the function keys, the cursor keys, and Alt plus a key.  The
  3365.               extended key code for a key is generally the same as the scan
  3366.               code for that key.
  3367.  
  3368.               Some keys, like the Alt, Ctrl, and Shift by themselves or in
  3369.               combination with each other, plus the Print Screen, SysReq,
  3370.               Scroll Lock, Pause, Break, Num Lock, and Caps Lock do not have
  3371.               any code representations at all.  The computer performs
  3372.               special actions automatically when you press these keys (for
  3373.               example, it switches your keyboard into Caps Lock mode when
  3374.               you press the Caps Lock key), and does not report the
  3375.               keystrokes to whatever program is running unless the program
  3376.               has been written specially to accept them.
  3377.  
  3378.               It is up to the computer to smooth over the differences
  3379.               between the different keyboards.  That is part of the reason
  3380.               why not all keyboards can be used with all computers.
  3381.  
  3382.               Appendix B has a complete list of ASCII and scan codes of each
  3383.               of the keys on your keyboard.
  3384.  
  3385.  
  3386.           Video
  3387.  
  3388.               4DOS is a "character-based" program, which means that it works
  3389.               in text mode on your computer.  In text mode, the screen
  3390.               displays text in a single font, but cannot mix fonts or
  3391.               display graphics.  4DOS can run graphics programs which change
  3392.               your screen to graphics mode, but the screen must be returned
  3393.               to text mode whenever 4DOS is active.  In the early days of
  3394.               the IBM PC, text mode was a single, simple video operating
  3395.               environment.  Today, advanced video boards and video software
  3396.               have created a wide range of text modes.
  3397.  
  3398.               The original IBM PC monochrome and CGA color video cards can
  3399.               display 80 columns and 25 rows of text.  Newer, advanced video
  3400.               systems normally run in this 80 x 25 display mode but can also
  3401.               display more columns and rows.  For example, EGA video cards
  3402.               can display 43 rows of text and VGA video cards can display 50
  3403.  
  3404.  
  3405.           ___________________________________________________________________
  3406.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  52
  3407.  
  3408.                                                  CHAPTER 4 / GENERAL CONCEPTS
  3409.           ___________________________________________________________________
  3410.  
  3411.  
  3412.               rows.  With special driver programs, a VGA can display 60 rows
  3413.               or more and up to 132 columns of text.  Each of these
  3414.               different screen configurations is a different text mode.
  3415.  
  3416.               4DOS supports whatever number of rows and columns of text you
  3417.               decide to use.  It doesn't have commands to switch from one
  3418.               screen size to another -- you will need to use the software
  3419.               that came with your computer or video board to do that -- but
  3420.               it can read and work with the number of rows and columns on
  3421.               your screen.
  3422.  
  3423.  
  3424.           ANSI Drivers
  3425.  
  3426.               Every version of DOS includes a program called ANSI.SYS.  This
  3427.               program lets you use text colors other than drab white on
  3428.               black, redefine keys, and control screen output.  Commercial
  3429.               ANSI drivers are available as replacements for ANSI.SYS.  The
  3430.               commercial programs usually include many new features, boost
  3431.               screen display speed dramatically, and support text displays
  3432.               that have more than 80 columns and 25 lines.
  3433.  
  3434.               4DOS automatically determines whether you have an ANSI driver
  3435.               installed.  If you do, 4DOS will use the driver to clear the
  3436.               screen and set screen colors.
  3437.  
  3438.               Several 4DOS commands provide replacements for traditional
  3439.               ANSI.SYS commands.  For example, 4DOS has commands to set the
  3440.               screen colors and display text in specific colors.  These
  3441.               commands are easier to understand and use than traditional
  3442.               ANSI.SYS control sequences.  Some of these commands manipulate
  3443.               screen colors directly.  Others use an ANSI driver if one is
  3444.               installed, but save you the work of figuring out complex ANSI
  3445.               control sequences.  Any special interaction between 4DOS
  3446.               commands and the ANSI.SYS driver is described in the
  3447.               documentation for each command.
  3448.  
  3449.  
  3450.  
  3451.  
  3452.  
  3453.  
  3454.  
  3455.  
  3456.  
  3457.  
  3458.  
  3459.  
  3460.  
  3461.  
  3462.           ___________________________________________________________________
  3463.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  53
  3464.  
  3465.                                                        CHAPTER 5 / USING 4DOS
  3466.           ___________________________________________________________________
  3467.  
  3468.  
  3469.  
  3470.           CHAPTER 5 / USING 4DOS
  3471.  
  3472.  
  3473.           4DOS is both a collection of commands and a set of features which
  3474.           make your computer easier to use.  The commands are explained in
  3475.           the Command Reference section which begins on page 166.  This
  3476.           section of the manual primarily explains each of the 4DOS features
  3477.           that are not directly related to individual commands.
  3478.  
  3479.           Most of the features described in this section are easy to use, but
  3480.           a few are more technical in nature.  Such features are marked with
  3481.           a ## next to the feature name or the paragraph which describes the
  3482.           feature's operation.
  3483.  
  3484.           As you read through this section, we urge you to experiment with
  3485.           the features that catch your interest and pass over any which seem
  3486.           too complicated.  Come back to this section as you gain expertise
  3487.           with 4DOS, and you will probably discover that the more complex
  3488.           features will seem easy and very useful.  4DOS doesn't require that
  3489.           you learn any more than you want, and even if you are a computer
  3490.           novice, you'll find some features that will interest you
  3491.           immediately.
  3492.  
  3493.           If you come across terms or concepts in this chapter that you are
  3494.           unsure about, refer to Chapter 4 / General Concepts, the Glossary
  3495.           on page 355, or the Index.
  3496.  
  3497.  
  3498.           At the Command Line
  3499.  
  3500.               4DOS displays a c:\> prompt when it is waiting for you to
  3501.               enter a command.  (The actual text depends on the current
  3502.               drive and directory, as well as your PROMPT settings.)  This
  3503.               is called the command line and the prompt is 4DOS's way of
  3504.               asking you to enter a command, an alias or batch file name, or
  3505.               the instructions necessary to begin an application program.
  3506.  
  3507.               This section of the manual explains the 4DOS features that
  3508.               will help you while you are typing in commands, and how 4DOS
  3509.               interprets keystrokes entered at the command line.  The
  3510.               keystrokes discussed here are the ones 4DOS normally uses.  If
  3511.               you prefer using different keystrokes to perform these
  3512.               functions, you can reassign virtually all 4DOS keystrokes with
  3513.               keystroke directives in the 4DOS.INI configuration file (see
  3514.               page 119).
  3515.  
  3516.  
  3517.  
  3518.  
  3519.           ___________________________________________________________________
  3520.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  54
  3521.  
  3522.                                                        CHAPTER 5 / USING 4DOS
  3523.           ___________________________________________________________________
  3524.  
  3525.  
  3526.               Command Line Editing
  3527.  
  3528.               The 4DOS command line works like a single-line word processor,
  3529.               allowing you to edit any part the command line at any time
  3530.               before you press Enter to execute the command, or Esc to erase
  3531.               it.  4DOS extends the command line to a maximum of 255
  3532.               characters, and allows you to edit the command line even when
  3533.               it exceeds the width of your screen.
  3534.  
  3535.               4DOS recognizes the following editing keys when you are typing
  3536.               a command (the words Ctrl and Shift mean to press the Ctrl
  3537.               [Control] or Shift key together with the other key named):
  3538.  
  3539.               Cursor Movement:
  3540.  
  3541.                     Left arrow       Move the cursor left one character.
  3542.                     Right arrow      Move the cursor right one character.
  3543.                     Ctrl-Left arrow  Move the cursor left one word.
  3544.                     Ctrl-Right arrow Move the cursor right one word.
  3545.                     Home             Move the cursor to the beginning of the
  3546.                                      line.
  3547.                     End              Move the cursor to the end of the line.
  3548.  
  3549.               Insert and Delete:
  3550.  
  3551.                     Ins              Toggle between insert and overtype
  3552.                                      mode.
  3553.                     Del              Delete the character at the cursor.
  3554.                     Backspace        Delete the character to the left of the
  3555.                                      cursor.
  3556.                     Ctrl-L           Delete the word or partial word to the
  3557.                                      left of the cursor.
  3558.                     Ctrl-R or
  3559.                     Ctrl-Backspace   Delete the word or partial word to the
  3560.                                      right of the cursor.
  3561.                     Ctrl-Home        Delete from the beginning of the line
  3562.                                      to the cursor.
  3563.                     Ctrl-End         Delete from the cursor to the end of
  3564.                                      the line.
  3565.                     Esc              Delete the entire line.
  3566.                     Ctrl-C or
  3567.                     Ctrl-Break       Cancel the command.
  3568.                     Enter or Return  Execute the command line.
  3569.  
  3570.            ## Sometimes you may need to have 4DOS interpret a keystroke
  3571.               literally and place it on the command line instead of
  3572.               performing the usual action listed above.  For example,
  3573.               suppose you have a program that requires a Ctrl-R character on
  3574.  
  3575.  
  3576.           ___________________________________________________________________
  3577.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  55
  3578.  
  3579.                                                        CHAPTER 5 / USING 4DOS
  3580.           ___________________________________________________________________
  3581.  
  3582.  
  3583.               its command line.  Normally you couldn't type this keystroke
  3584.               at the 4DOS prompt, because 4DOS would interpret it as a
  3585.               "Delete word right" command.
  3586.  
  3587.               To get around this problem, use the special keystroke Alt-255.
  3588.               You enter Alt-255 by holding down the Alt key while you type
  3589.               255 on the numeric keypad, then releasing the Alt key (you
  3590.               must use the number keys on the numeric pad; the row of keys
  3591.               at the top of your keyboard won't work).  When 4DOS sees the
  3592.               Alt-255, it interprets the next keystroke literally and places
  3593.               it on the command line, ignoring any special meaning it would
  3594.               normally have as a 4DOS command line editing or history
  3595.               keystroke.  You can use Alt-255 to suppress the normal meaning
  3596.               of command line editing keystrokes even if they have been
  3597.               reassigned with key mapping directives in 4DOS.INI (see page
  3598.               119), and Alt-255 itself can be reassigned with the
  3599.               CommandEscape directive.
  3600.  
  3601.  
  3602.               Command History and Recall
  3603.  
  3604.               Each time you execute a command, 4DOS saves the command line
  3605.               in a command history list.  4DOS lets you display the saved
  3606.               commands, search the list, modify commands, and rerun
  3607.               commands.
  3608.  
  3609.               The simplest use of the command history list is to repeat a
  3610.               command exactly.  For example, you might enter the command
  3611.  
  3612.                    c:\> dir b:*.wks;*.doc
  3613.  
  3614.               to see some of the files on drive B.  You might move some new
  3615.               files to drive B and then want to repeat the DIR command.
  3616.               Just press the Up Arrow key repeatedly to scan back through
  3617.               the history list.  When the DIR command appears, press Enter
  3618.               to execute it again.
  3619.  
  3620.               After you have found a command, you can edit it before
  3621.               pressing Enter.  You will appreciate this feature when you
  3622.               have to execute a series of commands that differ only slightly
  3623.               from each other.
  3624.  
  3625.               The history list is "circular".  If you move to the last
  3626.               command in the list and then press the down arrow one more
  3627.               time, you'll see the first command in the list.  Similarly, if
  3628.               you move to the first command in the list and then press the
  3629.               up arrow one more time, you'll see the last command in the
  3630.               list.
  3631.  
  3632.  
  3633.           ___________________________________________________________________
  3634.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  56
  3635.  
  3636.                                                        CHAPTER 5 / USING 4DOS
  3637.           ___________________________________________________________________
  3638.  
  3639.  
  3640.               You can have 4DOS search the command history list to find a
  3641.               previous command quickly using command completion.  Just enter
  3642.               the first few characters of the command you want to find and
  3643.               press Up Arrow.  You only need to enter enough characters to
  3644.               identify the command that you want to find.  For example, to
  3645.               find the DIR command, enter DI and then press Up Arrow.  If
  3646.               you press the Up Arrow key a second time, 4DOS will display
  3647.               the next command that matches.  4DOS will beep if there are no
  3648.               matching commands.  The search process stops as soon as you
  3649.               type one of the 4DOS editing keys, whether or not the line is
  3650.               changed.  At that point, the line you're viewing becomes the
  3651.               new line to match if you press Up Arrow again.
  3652.  
  3653.               You can specify the size of the command history list with the
  3654.               History directive in 4DOS.INI (see page 126).  When the list
  3655.               is full, 4DOS discards the oldest commands to make room for
  3656.               new ones.  You can also use the HistMin directive in 4DOS.INI
  3657.               to enable or disable history saves and to specify the shortest
  3658.               command line that 4DOS will save (see page 131).
  3659.  
  3660.               You can prevent 4DOS from saving a command line by beginning
  3661.               it with an at-sign [@].
  3662.  
  3663.               Command History Keys:
  3664.  
  3665.                     Up Arrow         Recall the previous (or most recent)
  3666.                                      command, or the most recent command
  3667.                                      that matches a partial command line.
  3668.                     Down Arrow       Recall the next (or oldest) command, or
  3669.                                      the oldest command that matches a
  3670.                                      partial command line.
  3671.                     F3               Fill in the rest of the command line
  3672.                                      from the previous command, beginning at
  3673.                                      the current cursor position.
  3674.                     Ctrl-D           Delete the currently displayed history
  3675.                                      list entry, erase the command line, and
  3676.                                      display the previous matching history
  3677.                                      list entry.
  3678.                     Ctrl-E           Display the last entry in the history
  3679.                                      list.
  3680.                     Ctrl-K           Save the current command line in the
  3681.                                      history list without executing it, and
  3682.                                      then clear the command line
  3683.                     @                As the first character in a line:  Do
  3684.                                      not save the current line in the
  3685.                                      history list when it is executed; do
  3686.                                      not store it in the CMDLINE environment
  3687.                                      variable; and remove the CMDLINE
  3688.  
  3689.  
  3690.           ___________________________________________________________________
  3691.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  57
  3692.  
  3693.                                                        CHAPTER 5 / USING 4DOS
  3694.           ___________________________________________________________________
  3695.  
  3696.  
  3697.                                      variable from the environment (this
  3698.                                      helps reduce environment space when
  3699.                                      loading TSRs).
  3700.  
  3701.               Use F3 when your new command is different from your old one by
  3702.               just a character or two at the beginning.  For example,
  3703.               suppose you want to execute a DIR on several file names then
  3704.               use DEL to delete those same files.  After the DIR is complete
  3705.               type DEL and press F3; the rest of the command line will be
  3706.               completed for you.  Check that it's correct, and then press
  3707.               Enter to delete the files.  F3 also retrieves the entire
  3708.               previous command (like up-arrow) if nothing has been typed on
  3709.               the line.
  3710.  
  3711.               Use Ctrl-E to "get your bearings" by returning to the end of
  3712.               the list if you've scrolled around so much that you aren't
  3713.               sure where you are any more.
  3714.  
  3715.               Use Ctrl-K to save some work when you've typed a long command
  3716.               and then realize that you weren't quite ready.  For example,
  3717.               if you forget to change directories and notice it after a
  3718.               command is typed or mostly typed, but before you press Enter,
  3719.               just press Ctrl-K to save the command without executing it.
  3720.               Use the CD or CDD command to change to the right directory,
  3721.               press up-arrow twice to retrieve the command you saved, make
  3722.               any final changes to it, and press Enter to execute it.
  3723.  
  3724.  
  3725.               Command History Window
  3726.  
  3727.               You can also view the command history in a scrollable history
  3728.               window, and select the command to modify or re-execute from
  3729.               those displayed in the window.  To activate the history window
  3730.               press PgUp or PgDn at the command line.  4DOS will display a
  3731.               window in the upper right corner of the screen, with the
  3732.               command you most recently executed marked with a highlight.
  3733.               (If you just finished re-executing a command from the history,
  3734.               then the next command in sequence will be highlighted.)
  3735.  
  3736.               You can scroll the history window up and down one line at a
  3737.               time with Up Arrow and Down Arrow, and one page (screen) at a
  3738.               time with PgUp and PgDn.  The display is not circular as it is
  3739.               at the prompt, it has fixed beginning and end points.  Home or
  3740.               Ctrl-PgUp will go to the beginning of the history, and End or
  3741.               Ctrl-PgDn will go to the end.  The Ctrl-D (delete from
  3742.               history) key works within the history as it does at the
  3743.               command line.
  3744.  
  3745.  
  3746.  
  3747.           ___________________________________________________________________
  3748.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  58
  3749.  
  3750.                                                        CHAPTER 5 / USING 4DOS
  3751.           ___________________________________________________________________
  3752.  
  3753.  
  3754.               Once you have selected a command in the history window, press
  3755.               Enter to execute it immediately, or Ctrl-Enter to move the
  3756.               line to the prompt for editing (you can not edit the line
  3757.               directly in the history window).
  3758.  
  3759.               You can bring up a "filtered" history window by typing some
  3760.               characters on the command line, then pressing PgUp or PgDn.
  3761.               Only those commands matching the typed characters will be
  3762.               displayed in the window.
  3763.  
  3764.               You can control the position and size of the history window
  3765.               with directives in 4DOS.INI (see page 132).  You can also
  3766.               change the keys used in the window with key mapping directives
  3767.               in 4DOS.INI (see page 137).
  3768.  
  3769.               Command History Window:
  3770.  
  3771.                     PgUp or PgDn     (from the command line) Open the
  3772.                                      command history window.
  3773.                     Up Arrow         Scroll the display up one line.
  3774.                     Down Arrow       Scroll the display down one line.
  3775.                     PgUp             (inside the window) Scroll the display
  3776.                                      up one page.
  3777.                     PgDn             (inside the window) Scroll the display
  3778.                                      down one page.
  3779.                     Ctrl-PgUp or HomeGo to the beginning of the history
  3780.                                      list.
  3781.                     Ctrl-PgDn or End Go to the end of the history list.
  3782.                     Ctrl-D           Delete the selected line from the
  3783.                                      history list.
  3784.                     Enter            Execute the selected line.
  3785.                     Ctrl-Enter       Move the selected line to the command
  3786.                                      line for editing.
  3787.  
  3788.  
  3789.               Filename Completion
  3790.  
  3791.               4DOS's filename completion can help you by filling in a
  3792.               complete file name on the command line when you only remember
  3793.               part of the name.  For example, suppose you want to copy a
  3794.               file.  You know that its name begins AU but you can't remember
  3795.               the rest of the name.  Type
  3796.  
  3797.                    c:\> copy au
  3798.  
  3799.               and then press the Tab key or F9 key.  4DOS will search the
  3800.               current directory for filenames that begin AU and insert the
  3801.  
  3802.  
  3803.  
  3804.           ___________________________________________________________________
  3805.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  59
  3806.  
  3807.                                                        CHAPTER 5 / USING 4DOS
  3808.           ___________________________________________________________________
  3809.  
  3810.  
  3811.               first one onto the command line in place of the AU that you
  3812.               typed.
  3813.  
  3814.               If 4DOS found the file that you want, simply complete the
  3815.               command.  If it didn't find the file that you were looking
  3816.               for, press Tab again to substitute the next filename that
  3817.               begins with AU.  When there are no more filenames that match
  3818.               your pattern, 4DOS will beep each time you press Tab or F9.
  3819.  
  3820.               If you go past the filename that you want, press Shift-Tab or
  3821.               F8 to back up and 4DOS will return to the previous matching
  3822.               filename.  After you back up to the first filename, 4DOS will
  3823.               beep each time you press Shift-Tab.
  3824.  
  3825.               If you want to enter more than one matching filename on the
  3826.               same command line, press F10 when each desired name appears.
  3827.               4DOS will keep that name and place the next matching filename
  3828.               after it on the command line.  You can then use Tab (or F8)
  3829.               and Shift-Tab (or F9) to move through the remaining matching
  3830.               files.
  3831.  
  3832.               The pattern you use for matching may contain any valid
  3833.               filename characters, as well as wildcard characters and 4DOS's
  3834.               extended wildcards (see page 71).  For example, you can copy
  3835.               the first matching .TXT file by typing
  3836.  
  3837.                    c:\> copy *.txt
  3838.  
  3839.               and then pressing Tab.
  3840.  
  3841.               If you don't specify part of a filename before pressing Tab,
  3842.               4DOS will use *.* as the matching pattern.  If you type a
  3843.               filename without an extension, 4DOS will add *.* to the name.
  3844.               It will also place a "*" after a partial extension.  If you
  3845.               are typing a group of file names in an include list (see page
  3846.               74), 4DOS will use the part of the include list at the cursor
  3847.               as the pattern to match.
  3848.  
  3849.               When filename completion is used at the start of the command
  3850.               line, 4DOS will only try to match directories, executable
  3851.               files (.COM, .EXE, .BTM, and .BAT), and files with executable
  3852.               extensions, since these are the only file names that it makes
  3853.               sense to use at the start of a command.  If a directory is
  3854.               found a "\" will be appended to enable an automatic directory
  3855.               change (see below).
  3856.  
  3857.               If you would rather select files from a list of matching file
  3858.               names, see the SELECT command on page 296.
  3859.  
  3860.  
  3861.           ___________________________________________________________________
  3862.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  60
  3863.  
  3864.                                                        CHAPTER 5 / USING 4DOS
  3865.           ___________________________________________________________________
  3866.  
  3867.  
  3868.               Filename Completion Keys:
  3869.  
  3870.                     F8 or Shift-Tab  Get the previous matching filename.
  3871.                     F9 or Tab        Get the next matching filename.
  3872.                     F10              Keep the current matching filename and
  3873.                                      display the next matching name
  3874.                                      immediately after the current one.
  3875.  
  3876.  
  3877.               Multiple Commands
  3878.  
  3879.               At times, you probably know the next two or three commands
  3880.               that you want 4DOS to execute.  Instead of waiting for each
  3881.               one to finish before you type the next, you can type them all
  3882.               on the same command line, separated by a caret [^].  For
  3883.               example, if you know you want to copy all of your .TXT files
  3884.               to drive A: and then run CHKDSK to be sure that drive A's file
  3885.               structure is in good shape, you can type the following command
  3886.               line:
  3887.  
  3888.                    c:\> copy *.txt a: ^ chkdsk a:
  3889.  
  3890.               If you don't like using the caret as the command separator,
  3891.               you can pick another character using the SETDOS command (see
  3892.               page 305) or the CommandSep directive in 4DOS.INI (see page
  3893.               130).
  3894.  
  3895.               You may put as many commands on the command line as you wish,
  3896.               as long as the total length of the command line does not
  3897.               exceed 255 characters.
  3898.  
  3899.               You can use multiple commands in batch files (see page 99) and
  3900.               alias definitions (see page 96) as well as from the command
  3901.               line.
  3902.  
  3903.  
  3904.               Automatic Directory Changes
  3905.  
  3906.               4DOS's automatic directory change feature gives you a quick
  3907.               method for changing directories.  You can use an automatic
  3908.               directory change in place of the CD or CDD command.  To do so,
  3909.               simply type the name of the directory you want to change to at
  3910.               the prompt, with a backslash [\] at the end, and 4DOS will
  3911.               switch to that directory.  For example:
  3912.  
  3913.                    c:\> 4dos\
  3914.                    c:\4dos>
  3915.  
  3916.  
  3917.  
  3918.           ___________________________________________________________________
  3919.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  61
  3920.  
  3921.                                                        CHAPTER 5 / USING 4DOS
  3922.           ___________________________________________________________________
  3923.  
  3924.  
  3925.               This feature can make directory changes very simple when it's
  3926.               combined with the CDPATH environment variable (see page 117).
  3927.               CDPATH includes a list of directories for the CD and CDD
  3928.               commands to search if the directory you name does not exist
  3929.               below the current directory.  Automatic directory changes use
  3930.               CDPATH as well.  For example, suppose CDPATH is set to
  3931.               C:\;D:\;E:\, and the directory WIN exists on drive E:.  You
  3932.               can change to this directory with a single word on the command
  3933.               line:
  3934.  
  3935.                    c:\4dos> win\
  3936.                    e:\win>
  3937.  
  3938.               In executing the command shown above, 4DOS first looks for a
  3939.               WIN subdirectory of the current directory, i.e. C:\4DOS\WIN.
  3940.               If no such directory exists it looks for a WIN subdirectory in
  3941.               every directory in the CDPATH list, and changes to the first
  3942.               one it finds.
  3943.  
  3944.               Internally, automatic directory changes use the CDD command,
  3945.               so the text before the backslash can include a drive letter, a
  3946.               full path, or a partial path.  Arguments like "...." are
  3947.               allowed.  Automatic directory changes save the current
  3948.               directory, so it can be recalled with a "CDD -" or "CD -"
  3949.               command.  For more information on directory changes see CD on
  3950.               page 189 and CDD on page 191.
  3951.  
  3952.               Automatic directory changes will not work if the directory
  3953.               name you enter is the same as the name of a 4DOS internal
  3954.               command.  4DOS always checks for internal commands before
  3955.               automatic directory changes, to allow commands like CD\ to
  3956.               work.
  3957.  
  3958.  
  3959.               Temporarily Disabling Aliases
  3960.  
  3961.               At times, you may want to temporarily disable an alias that
  3962.               you have defined.  You may have an alias that changes the
  3963.               defaults of a particular command, for example, and want to run
  3964.               the unmodified version of the command.  To do so, precede the
  3965.               command name with an asterisk [*].  For example, if you have
  3966.               an alias for DIR which displays directories in 2-column paged
  3967.               mode by default, you can use the following command to display
  3968.               a directory in the normal single-column, non-paged mode:
  3969.  
  3970.                    c:\> *dir
  3971.  
  3972.  
  3973.  
  3974.  
  3975.           ___________________________________________________________________
  3976.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  62
  3977.  
  3978.                                                        CHAPTER 5 / USING 4DOS
  3979.           ___________________________________________________________________
  3980.  
  3981.  
  3982.               Command Line Help
  3983.  
  3984.               4DOS includes a complete help program (called 4HELP.EXE).  The
  3985.               help system includes complete help for all 4DOS internal
  3986.               commands, all standard DOS external commands, and many 4DOS
  3987.               features.  It is indexed and fully cross-referenced, so you
  3988.               can move easily among related commands.
  3989.  
  3990.               You can start the 4DOS help system to get help for any 4DOS or
  3991.               DOS command in several different ways.
  3992.  
  3993.               If you type HELP at the 4DOS prompt, a list of all help topics
  3994.               will be displayed.  Move the cursor bar to the topic you want
  3995.               using a mouse or the arrow keys, and press Enter to see help
  3996.               on that topic.
  3997.  
  3998.               If you type HELP followed by a topic on the command line, 4DOS
  3999.               will skip the opening help screen and go directly to that
  4000.               topic.  For example, if you need help with the COPY command,
  4001.               you can type:
  4002.  
  4003.                    help copy
  4004.  
  4005.               If you press F1 at the 4DOS prompt, 4DOS will display the list
  4006.               of all help topics just as if you had entered the HELP
  4007.               command.  If you have already typed part or all of a command
  4008.               on the line, 4DOS will provide "context-sensitive" help by
  4009.               using the first word on the line as a help topic.  If it's a
  4010.               valid topic, you will see help for that topic automatically;
  4011.               if not, you will see the list of all help topics and you can
  4012.               pick the topic you want.  For example, if you press F1 after
  4013.               entering each of the command lines shown below you will get
  4014.               the display indicated:
  4015.  
  4016.                    c:\>                      List of help topics
  4017.                    c:\> copy *.* a:          Help on COPY
  4018.                    c:\> c:\util\map          List of help topics
  4019.  
  4020.               If you type the name of any 4DOS internal command at the 4DOS
  4021.               prompt, followed by a slash and a question mark [/?] like
  4022.               this:
  4023.  
  4024.                    copy /?
  4025.  
  4026.               then 4DOS will display help for the command in a "quick-
  4027.               reference" style.  Output from a /? display may be redirected
  4028.               with > or >>.  The /? option may not work correctly if you
  4029.               have redefined how the command operates with an alias.  In
  4030.  
  4031.  
  4032.           ___________________________________________________________________
  4033.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  63
  4034.  
  4035.                                                        CHAPTER 5 / USING 4DOS
  4036.           ___________________________________________________________________
  4037.  
  4038.  
  4039.               this case you may need to add an asterisk to the beginning of
  4040.               the command to prevent 4DOS from processing the alias:
  4041.  
  4042.                    alias copy copy /r
  4043.                    *copy /?
  4044.  
  4045.               /? will only access the 4DOS help system when you use it with
  4046.               a 4DOS internal command.  If you use it with an external
  4047.               command name, the external command will be executed and will
  4048.               interpret the /? parameter according to its own rules.  Some
  4049.               external commands, including MS-DOS 5.0 external utility
  4050.               programs,  do display help when run with a /? parameter, but
  4051.               this a characteristic of these commands and does not depend on
  4052.               4DOS.  Many other external commands do not have this feature.
  4053.  
  4054.               Once you've started the 4DOS help system with HELP or F1, you
  4055.               can use a standard set of keystrokes to navigate.  The table
  4056.               below gives a brief summary of keys you can use in the help
  4057.               topic list, and in a help text screen; for details see the
  4058.               topic -HELP- in the help system itself.  The -HELP- topic also
  4059.               explains how to use a mouse within the help system.
  4060.  
  4061.               Help topic list keys:
  4062.  
  4063.                     Arrow Keys       Move the highlight to a different
  4064.                                      topic.
  4065.                     Enter            Display help on the highlighted topic.
  4066.                     Esc              Return to 4DOS.
  4067.                     Any other key    Attempt to match the characters typed
  4068.                                      with one of the names in the topic
  4069.                                      list.
  4070.  
  4071.               Help text screen keys:
  4072.  
  4073.                     Up Arrow         Scroll up one line in the display.
  4074.                     Down Arrow       Scroll down one line in the display.
  4075.                     PgUp             Scroll up one page in the display.
  4076.                     PgDn             Scroll down one page in the display.
  4077.                     Left Arrow       Move the cross-reference highlight to
  4078.                                      the previous item.
  4079.                     Right Arrow      Move the cross-reference highlight to
  4080.                                      the next item.
  4081.                     Enter            Switch to the topic shown by the
  4082.                                      highlighted cross-reference item.
  4083.                     Esc              Return to the topic list, or back to
  4084.                                      4DOS if this topic was displayed
  4085.                                      directly without using the topic list.
  4086.  
  4087.  
  4088.  
  4089.           ___________________________________________________________________
  4090.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  64
  4091.  
  4092.                                                        CHAPTER 5 / USING 4DOS
  4093.           ___________________________________________________________________
  4094.  
  4095.  
  4096.                     F1               Go to the topic list in order to select
  4097.                                      a new topic.
  4098.                     Alt-N
  4099.                       or Ctrl-Right  View the next topic in the topic list.
  4100.                     Alt-P
  4101.                       or Ctrl-Left   View the previous topic in the topic
  4102.                                      list.
  4103.                     Alt-F1           View the previously displayed topic.
  4104.                     Alt-X            Return directly to 4DOS without
  4105.                                      restoring the original screen contents.
  4106.                     Ctrl-P           Print the text for the current topic on
  4107.                                      LPT1.
  4108.  
  4109.               The help system normally restores the screen when exiting.
  4110.               Use Alt-X to leave a page of help text on the screen so you
  4111.               can refer to it.  You can use Ctrl-P to print the topic you
  4112.               are viewing.  Your printer must be turned on and ready before
  4113.               pressing Ctrl-P.
  4114.  
  4115.  
  4116.           Input and Output
  4117.  
  4118.               4DOS commands and many programs get their input from the
  4119.               computer's standard input device and send their output to the
  4120.               standard output device.  Some programs also send special
  4121.               messages to the standard error device.  Normally, the keyboard
  4122.               is used for standard input and the video screen for both
  4123.               standard output and standard error.  But you can temporarily
  4124.               change these devices for special tasks.
  4125.  
  4126.               For example, suppose you want a printed list of the files in a
  4127.               directory.  If you change the standard output to the printer
  4128.               and issue a DIR command, the task is easy.  DIR prints to
  4129.               standard output, and you have redirected standard output to
  4130.               the printer, so the DIR command prints filenames instead of
  4131.               displaying them on the screen.  You can just as easily send
  4132.               the output of DIR (or any other command) to a file or a serial
  4133.               port.
  4134.  
  4135.               4DOS has three methods of manipulating input and output:
  4136.               Redirection, Piping, and the Keystack.  All three are
  4137.               explained in this section.
  4138.  
  4139.               Redirection and piping affect the standard input, standard
  4140.               output, and standard error devices.  They do not work with
  4141.               application programs which read the keyboard hardware
  4142.               directly, or which write directly to the screen.
  4143.  
  4144.  
  4145.  
  4146.           ___________________________________________________________________
  4147.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  65
  4148.  
  4149.                                                        CHAPTER 5 / USING 4DOS
  4150.           ___________________________________________________________________
  4151.  
  4152.  
  4153.               Redirection
  4154.  
  4155.               Redirection replaces standard input, standard output, and
  4156.               standard error with another device like the printer or serial
  4157.               port, or with a file.  The redirection lasts for one command
  4158.               and then everything returns to normal.  You have to use some
  4159.               discretion when you use redirection with a device;  there is
  4160.               no way to get input from the printer, for example.
  4161.  
  4162.               In the descriptions below, filename means either the name of a
  4163.               file or of an appropriate device (PRN, LPT1, LPT2, or LPT3 for
  4164.               printers; COM1 to COM4 for serial ports; CON for the keyboard
  4165.               and screen; etc.).
  4166.  
  4167.               To use redirection, place the redirection symbol and filename
  4168.               at the end of the command line, after the command name and any
  4169.               parameters.  For example, to redirect the output of the DIR
  4170.               command to a file called DIRLIST, you could use a command line
  4171.               like this:
  4172.  
  4173.                    c:\> dir /b1 *.dat > dirlist
  4174.  
  4175.               You can use both input and output redirection for the same
  4176.               command, if both are appropriate:
  4177.  
  4178.                    c:\> sort < dirlist > dirlist.srt
  4179.  
  4180.               Here are the redirection options supported by 4DOS:
  4181.  
  4182.                    To get input from a file or device instead of from the
  4183.                    keyboard:
  4184.  
  4185.                         < filename
  4186.  
  4187.                    To redirect standard output to a file or device:
  4188.  
  4189.                         > filename
  4190.  
  4191.                    To redirect standard output and standard error to a file
  4192.                    or device:
  4193.  
  4194.                         >& filename
  4195.  
  4196.                    To redirect standard error only to a file or device:
  4197.  
  4198.                         >&> filename
  4199.  
  4200.  
  4201.  
  4202.  
  4203.           ___________________________________________________________________
  4204.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  66
  4205.  
  4206.                                                        CHAPTER 5 / USING 4DOS
  4207.           ___________________________________________________________________
  4208.  
  4209.  
  4210.               If you want to append output to the end of a file, replace the
  4211.               first ">" in the last three commands above with ">>" (use >>,
  4212.               >>&, and >>&>).
  4213.  
  4214.            ## When output is directed to a file with >, >&, or >&>, if the
  4215.               file already exists, it will be overwritten.  You can protect
  4216.               existing files by using the SETDOS /N1 command (see page 305)
  4217.               or the NoClobber directive in 4DOS.INI (see page 132).
  4218.  
  4219.            ## When output is appended to a file with >>, >>&, or >>&>, the
  4220.               file will be created if it doesn't already exist.  Setting
  4221.               NoClobber will also prevent the creation of a new file.  You
  4222.               can temporarily override the current setting of NoClobber by
  4223.               using an exclamation mark [!] after the redirection symbol.
  4224.               For example, to redirect the output of DIR to the file DIROUT,
  4225.               and allow overwriting of any existing file despite the
  4226.               NoClobber setting:
  4227.  
  4228.                    c:\> dir >! dirout
  4229.  
  4230.            ## 4DOS redirection is fully nestable.  For example, you can
  4231.               invoke a batch file and redirect all of its output to a file
  4232.               or device.  Output redirection on a command within the batch
  4233.               file will take effect for that command only; when the command
  4234.               is completed, output will revert to the redirected output file
  4235.               or device in use for the batch file as a whole.
  4236.  
  4237.            ## For another method of changing the standard input and output
  4238.               devices see CTTY on page 203.
  4239.  
  4240.  
  4241.               Piping
  4242.  
  4243.               You can also create a "pipe," which means sending the standard
  4244.               output of one command to the standard input of another
  4245.               command.  To send the standard output of command1 to the
  4246.               standard input of command2:
  4247.  
  4248.                    command1 | command2
  4249.  
  4250.               To send the standard output and standard error of command1 to
  4251.               the standard input of command2:
  4252.  
  4253.                    command1 |& command2
  4254.  
  4255.               For example, to take the output of the SET command (which
  4256.               displays a list of your environment variables and their
  4257.  
  4258.  
  4259.  
  4260.           ___________________________________________________________________
  4261.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  67
  4262.  
  4263.                                                        CHAPTER 5 / USING 4DOS
  4264.           ___________________________________________________________________
  4265.  
  4266.  
  4267.               values) and pipe it to the DOS SORT utility to generate a
  4268.               sorted list, you would use the command:
  4269.  
  4270.                    c:\> set | sort
  4271.  
  4272.               To do the same thing and then pipe the sorted list to 4DOS's
  4273.               LIST command for full-screen viewing (see page 264):
  4274.  
  4275.                    c:\> set | sort | list /s
  4276.  
  4277.            ## 4DOS creates one or two temporary files to hold the output of
  4278.               pipes.  The files are named P1.$00 and P2.$00.  By default,
  4279.               these files are stored in the root directory of the boot
  4280.               drive, but you can override this with either the TEMP4DOS or
  4281.               TEMP environment variable (see page 116).  The last character
  4282.               of the extension will change with the shell nesting level (0
  4283.               for the primary shell, 1 for the first secondary shell, and so
  4284.               on).
  4285.  
  4286.            ## The 4DOS commands TEE and Y (see pages 312 and 326) are "pipe
  4287.               fittings" which add more flexibility to pipes.
  4288.  
  4289.  
  4290.               Keystack
  4291.  
  4292.               The 4DOS Keystack overcomes two weaknesses of input
  4293.               redirection: many programs ignore standard input and read the
  4294.               keyboard directly, and input redirection doesn't end until the
  4295.               program or command terminates.  You can't, for example, use
  4296.               redirection to send the opening commands to a program and then
  4297.               type the rest of the commands yourself.  But the Keystack lets
  4298.               you do exactly that.
  4299.  
  4300.               The 4DOS Keystack, which is often used in batch files and
  4301.               aliases, sends keystrokes to an application program.  Once the
  4302.               Keystack is empty, the program will receive the rest of its
  4303.               input from the keyboard.  The Keystack is useful when you want
  4304.               a program to take certain actions automatically when it
  4305.               starts.
  4306.  
  4307.               The Keystack is invoked with the KEYSTACK command (see page
  4308.               257).  It depends on a small resident program called
  4309.               KSTACK.COM, which must be installed in your AUTOEXEC.BAT file
  4310.               (see page 115).  If you don't have KSTACK.COM installed, the
  4311.               KEYSTACK command will display an error message.  If you are
  4312.               using a multitasking system such as DESQview or Windows, see
  4313.               page 155 for information on loading KSTACK within a window.
  4314.  
  4315.  
  4316.  
  4317.           ___________________________________________________________________
  4318.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  68
  4319.  
  4320.                                                        CHAPTER 5 / USING 4DOS
  4321.           ___________________________________________________________________
  4322.  
  4323.  
  4324.               To place the letters, digits, and punctuation marks you would
  4325.               normally type for your program into the keystack, enclose them
  4326.               in double quotes:
  4327.  
  4328.                    c:\> keystack "myfile"
  4329.  
  4330.               Many other keys can be entered into the Keystack using their
  4331.               names.  This example puts the F1 key followed by the Enter key
  4332.               in the keystack:
  4333.  
  4334.                    c:\> keystack F1 Enter
  4335.  
  4336.               See the KEYSTACK command for details on how key names are
  4337.               entered and on using numeric key values along with or instead
  4338.               of key names.
  4339.  
  4340.               Some programs may require a delay between keystrokes.  You can
  4341.               insert a delay with the /W option, followed by a delay time in
  4342.               1/18-seconds.  To add a 1-second delay between the keystrokes
  4343.               in the previous example:
  4344.  
  4345.                    c:\> keystack F1 /W18 Enter
  4346.  
  4347.               Some programs clear all keystrokes from the keyboard buffer
  4348.               and then accept input.  Place a 0 (zero) in the keystack to
  4349.               tell such programs that the keyboard buffer is empty.  This
  4350.               example reports an empty keyboard buffer and then types
  4351.               myfile:
  4352.  
  4353.                    c:\> keystack 0 "myfile"
  4354.  
  4355.               Some programs require both the ASCII code and the key's scan
  4356.               code.  To put both together in the Keystack, multiply the scan
  4357.               code by  256, add the ASCII code, and use the resulting
  4358.               numeric value as an argument to KEYSTACK.  For example, the
  4359.               Enter key has a scan code of 28 and an ASCII code of 13.  The
  4360.               combined code is (28 * 256) + 13 = 7181.  To put the combined
  4361.               code for the Enter key on the keystack:
  4362.  
  4363.                    c:\> keystack 7181
  4364.  
  4365.               If a program has different uses for the similar keys on the
  4366.               regular keyboard and the numeric keypad, it will need combined
  4367.               codes.
  4368.  
  4369.               The following command creates an alias (see page 173) that
  4370.               will run a dBASE report called TIMEREP (it should be entered
  4371.               on one line):
  4372.  
  4373.  
  4374.           ___________________________________________________________________
  4375.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  69
  4376.  
  4377.                                                        CHAPTER 5 / USING 4DOS
  4378.           ___________________________________________________________________
  4379.  
  4380.  
  4381.                    c:\> alias drpt `keystack "use times index times" Enter
  4382.                         "report form timerep to print" Enter "quit" Enter
  4383.                          ^ dbase`
  4384.  
  4385.               This command creates an alias called DRPT which puts the
  4386.               following characters on the keystack:
  4387.  
  4388.                    the characters "use times index times"
  4389.                    the Enter key's code
  4390.                    the characters "report form timerep to print"
  4391.                    the Enter key's code
  4392.                    the characters "quit"
  4393.                    and one more Enter key
  4394.  
  4395.               The alias then runs the program dBASE which receives those
  4396.               characters just as if you had typed them.
  4397.  
  4398.               You may have to experiment with some programs to find the
  4399.               proper sequence of keystrokes.  Programs which bypass both DOS
  4400.               and the computer's BIOS, and read keystrokes directly from the
  4401.               keyboard hardware, will not accept input from the 4DOS
  4402.               Keystack.  Few programs fit into this category except memory-
  4403.               resident utilities.
  4404.  
  4405.               When you use the Keystack, remember that you must put the
  4406.               keystrokes into the Keystack before you run the program that
  4407.               will receive them.  The Keystack will hold the keystrokes
  4408.               until a program asks for them.
  4409.  
  4410.               See Appendix B on page 338 for a complete list of ASCII,
  4411.               extended key, and scan codes, and KEYSTACK on page 257 for
  4412.               more information.
  4413.  
  4414.  
  4415.           File Processing
  4416.  
  4417.               Most 4DOS commands (like COPY, DIR, etc.) and many external
  4418.               commands work on a file or a group of files.  Besides typing
  4419.               the exact name of the file you want to work with, you can use
  4420.               4DOS's shorthand forms of naming files:  Extended Parent
  4421.               Directory Names, Wildcards, Multiple Filenames, Include Lists,
  4422.               and Executable Extensions.  These four features are explained
  4423.               in this section.
  4424.  
  4425.               These features apply to 4DOS commands only, and generally can
  4426.               not be used to pass file names to external programs.  For
  4427.               example, 4DOS can understand the file name ...\FILE.DAT when
  4428.               it is used in an internal 4DOS command like COPY or MOVE.
  4429.  
  4430.  
  4431.           ___________________________________________________________________
  4432.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  70
  4433.  
  4434.                                                        CHAPTER 5 / USING 4DOS
  4435.           ___________________________________________________________________
  4436.  
  4437.  
  4438.               However your editor probably was not designed to support this
  4439.               extension to traditional DOS directory names, and is likely to
  4440.               give an error message if you try to pass it such a name.
  4441.  
  4442.               Remember throughout this section that a filename is a base
  4443.               name of 1 to 8 characters, optionally followed by an extension
  4444.               which is a period [.] and 1 to 3 more characters.
  4445.  
  4446.  
  4447.               Extended Parent Directory Names
  4448.  
  4449.               4DOS allows you to extend the traditional DOS ".." syntax for
  4450.               naming the parent directory, by adding additional [.]
  4451.               characters.  Each additional [.] represents an additional
  4452.               directory level above the current directory.  For example, to
  4453.               copy the file LETTERS.DAT from the directory C:\DATA to drive
  4454.               A:, while you are in a directory further down in the directory
  4455.               tree:
  4456.  
  4457.                    C:\DATA\FINANCE\JANUARY>copy ...\LETTERS.DAT A:
  4458.  
  4459.  
  4460.               Wildcards
  4461.  
  4462.               Wildcards let you specify a file or group of files by typing a
  4463.               partial filename.  4DOS scans the appropriate directory to
  4464.               find all of the files that match the partial name you have
  4465.               specified.
  4466.  
  4467.               Most 4DOS commands accept filenames with wildcards anywhere
  4468.               that a full filename can be used.  4DOS recognizes 2 wildcard
  4469.               characters, the asterisk [*] and the question mark [?], plus a
  4470.               special method of specifying a range of permissible
  4471.               characters.
  4472.  
  4473.               An asterisk [*] in a filename means "any zero or more
  4474.               characters in this position."  For example, this command will
  4475.               display a list of all files in the current directory,
  4476.               regardless of the length of each file's name:
  4477.  
  4478.                    c:\> dir *.*
  4479.  
  4480.               If you want to see all of the files with a .TXT extension, you
  4481.               could type this:
  4482.  
  4483.                    c:\> dir *.txt
  4484.  
  4485.  
  4486.  
  4487.  
  4488.           ___________________________________________________________________
  4489.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  71
  4490.  
  4491.                                                        CHAPTER 5 / USING 4DOS
  4492.           ___________________________________________________________________
  4493.  
  4494.  
  4495.               If you know that the file you are looking for has a base name
  4496.               that begins with ST and an extension that begins with .D, you
  4497.               can find it this way.  Filenames such as STATE.DAT,
  4498.               STEVEN.DOC, and ST.D will all be displayed:
  4499.  
  4500.                    c:\> dir st*.d*
  4501.  
  4502.               With 4DOS, you can also use the asterisk to match filenames
  4503.               with specific letters somewhere inside the name.  The
  4504.               following example will display any file with a .TXT extension
  4505.               that has the letters AM together anywhere inside its base
  4506.               name.  It will, for example, display AMPLE.TXT, STAMP.TXT,
  4507.               CLAM.TXT, and AM.TXT:
  4508.  
  4509.                    c:\> dir *am*.txt
  4510.  
  4511.               A question mark [?] matches any single filename character.
  4512.               Also, DOS automatically extends all base names to 8 characters
  4513.               and all extensions to 3 characters by adding blanks at the end
  4514.               of the names, if necessary.  The question mark wildcard will
  4515.               match one of these blanks as well as a normal character.  For
  4516.               example, if you have files called LETTER.DOC, LETTER1.DOC, and
  4517.               LETTERA.DOC, this command will display all three names:
  4518.  
  4519.                    c:\> dir letter?.doc
  4520.  
  4521.               You can put the question mark anywhere in a filename and use
  4522.               as many question marks as you need.  The following example
  4523.               will display files with names like LETTER.DOC and LATTER.DAT,
  4524.               and LITTER.DU:
  4525.  
  4526.                    c:\> dir l?tter.d??
  4527.  
  4528.               The use of an asterisk wildcard before other characters, and
  4529.               of the character ranges discussed below, is unique to 4DOS.
  4530.               These wildcards work only with 4DOS internal commands, not
  4531.               with external programs that accept file names and wildcards,
  4532.               unless such programs have been written especially to parallel
  4533.               4DOS's features.
  4534.  
  4535.            ## In some cases, the question mark wildcard may be too general.
  4536.               You can also tell 4DOS what characters you want to accept (or
  4537.               exclude) in a particular position in the filename by using
  4538.               square brackets.  Inside the brackets, you can put the
  4539.               individual acceptable characters or ranges of characters.  For
  4540.               example, if you wanted to match LETTER0.DOC through
  4541.               LETTER9.DOC, you could use this command:
  4542.  
  4543.  
  4544.  
  4545.           ___________________________________________________________________
  4546.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  72
  4547.  
  4548.                                                        CHAPTER 5 / USING 4DOS
  4549.           ___________________________________________________________________
  4550.  
  4551.  
  4552.                    c:\> dir letter[0-9].doc
  4553.  
  4554.               You could find all files that have a vowel as the second
  4555.               letter in their name this way.  This example also demonstrates
  4556.               how to mix the wildcard characters:
  4557.  
  4558.                    c:\> dir ?[aeiouy]*.*
  4559.  
  4560.               You can exclude a group of characters or a range of characters
  4561.               by using an exclamation mark [!] as the first character inside
  4562.               the brackets.  This example displays all filenames that are at
  4563.               least 2 characters long except those which have a vowel as the
  4564.               second letter in their names:
  4565.  
  4566.                    c:\> dir ?[!aeiouy]*.*
  4567.  
  4568.               The next example, which selects files such as AIP, BIP, and
  4569.               TIP but not NIP, demonstrates how you can use multiple ranges
  4570.               inside the brackets.  It will accept a file that begins with
  4571.               an A, B, C, D, T, U, or V:
  4572.  
  4573.                    c:\> dir [a-dt-v]ip
  4574.  
  4575.            ## You may use a question mark character inside the brackets, but
  4576.               its meaning is slightly different than a normal (unbracketted)
  4577.               question mark wildcard.  A normal question mark wildcard
  4578.               matches any character or an implied blank at the end of a name
  4579.               or extension.  4DOS will match a question mark inside brackets
  4580.               with any character but not with an implied blank.  For
  4581.               example,
  4582.  
  4583.                    c:\> dir letter[?].doc
  4584.  
  4585.               will display LETTER1.DOC and LETTERA.DOC, but not LETTER.DOC.
  4586.  
  4587.            ## You can repeat any of the wildcard characters in any
  4588.               combination you desire within a single file name.  For
  4589.               example, the following command lists all files which have an
  4590.               A, B, or C as the third character, followed by zero or more
  4591.               additional characters, followed by a D, E, or F, followed
  4592.               optionally by some additional characters, and with an
  4593.               extension beginning with P or Q.  You probably won't need to
  4594.               do anything this complex, but we've included it to show you
  4595.               the flexibility of 4DOS wildcards:
  4596.  
  4597.                    c:\> dir ??[abc]*[def]*.[pq]*
  4598.  
  4599.  
  4600.  
  4601.  
  4602.           ___________________________________________________________________
  4603.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  73
  4604.  
  4605.                                                        CHAPTER 5 / USING 4DOS
  4606.           ___________________________________________________________________
  4607.  
  4608.  
  4609.               Multiple Filenames
  4610.  
  4611.               Most 4DOS file processing commands can work with multiple
  4612.               files at one time.  To use multiple file names, you simply
  4613.               list the files one after another on the command line,
  4614.               separated by spaces.  You can use wildcards in any or all of
  4615.               the filenames.  For example, to copy all .TXT  and .DOC files
  4616.               from the current directory to drive A, you could use this
  4617.               command:
  4618.  
  4619.                    c:\> copy *.txt *.doc a:
  4620.  
  4621.               If the files you want to work with are not in the default
  4622.               directory, you must include the full path with each filename:
  4623.  
  4624.                    c:\> copy a:\details\file1.txt a:\details\file1.doc c:
  4625.  
  4626.             ! Multiple filenames are handy when you want to match a group of
  4627.               files which cannot be defined with a single filename and
  4628.               wildcards.  They let you be very specific about which files
  4629.               you want to work with in a command.  When you use multiple
  4630.               filenames with a command that expects both a source and a
  4631.               destination, like COPY or MOVE, be sure that you always
  4632.               include a specific destination on the command line.  If you
  4633.               don't, the command will assume that the last filename is the
  4634.               destination and may overwrite important files.
  4635.  
  4636.               Like extended wildcards and include lists (see below), the
  4637.               4DOS multiple filename feature will work with internal 4DOS
  4638.               commands but not with external programs unless those programs
  4639.               have been written to handle multiple file names on the command
  4640.               line.
  4641.  
  4642.               If you have a list of files to process that's too long to put
  4643.               on the command line or too time-consuming to type, see the
  4644.               SELECT command on page 296 for another way of passing multiple
  4645.               file names to a command.
  4646.  
  4647.  
  4648.               Include Lists
  4649.  
  4650.               Any 4DOS command that accepts multiple filenames can also
  4651.               accept one or more include lists.  An include list is simply a
  4652.               group of filenames, with or without wildcards, separated by
  4653.               semi-colons [;].  All files in the include list must be in the
  4654.               same directory.  You may not add a space on either side of the
  4655.               semi-colon.
  4656.  
  4657.  
  4658.  
  4659.           ___________________________________________________________________
  4660.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  74
  4661.  
  4662.                                                        CHAPTER 5 / USING 4DOS
  4663.           ___________________________________________________________________
  4664.  
  4665.  
  4666.               If you used an include list instead of multiple file names for
  4667.               the previous examples, they would look like this:
  4668.  
  4669.                    c:\> copy *.txt;*.doc a:
  4670.                    c:\> copy a:\details\*.txt;*.doc c:
  4671.  
  4672.               Include lists are similar to multiple filenames, but have
  4673.               three important differences.  First, you don't have to repeat
  4674.               the path to your files if you use an include list, because all
  4675.               of the included files must be in the same directory.  Second,
  4676.               if you use include lists, you aren't as likely to accidentally
  4677.               overwrite files if you forget a destination path for commands
  4678.               like COPY, because the last name in the list will be part of
  4679.               the include list, and won't be seen as the destination file
  4680.               name.  Include lists can only be used as the source parameter
  4681.               (the location files are coming from) for COPY and other
  4682.               similar commands.  They cannot be used to specify a
  4683.               destination for files.
  4684.  
  4685.               Third, multiple filenames and include lists are processed
  4686.               differently by the 4DOS DIR and SELECT commands.  If you use
  4687.               multiple filenames, all of the files matching the first
  4688.               filename are processed, then all of the files matching the
  4689.               second name, and so on.  When you use an include list, all
  4690.               files that match any entry in the include list are processed
  4691.               together, and will appear together in the directory display or
  4692.               SELECT list.  You can see this difference most clearly if you
  4693.               experiment with both techniques and the DIR command.  For
  4694.               example,
  4695.  
  4696.                    c:\> dir *.txt *.doc
  4697.  
  4698.               will list all the .TXT files with a directory header, the file
  4699.               list, and a summary of the total number of files and bytes
  4700.               used.  Then it will do the same for the .DOC files.  However,
  4701.  
  4702.                    c:\> dir *.txt;*.doc
  4703.  
  4704.               will display all the files in one list.
  4705.  
  4706.               Like extended wildcards and multiple filenames (see above),
  4707.               the 4DOS include list feature will work with internal 4DOS
  4708.               commands but not with external programs unless they have been
  4709.               programmed especially to parallel 4DOS's features.
  4710.  
  4711.  
  4712.  
  4713.  
  4714.  
  4715.  
  4716.           ___________________________________________________________________
  4717.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  75
  4718.  
  4719.                                                        CHAPTER 5 / USING 4DOS
  4720.           ___________________________________________________________________
  4721.  
  4722.  
  4723.               Executable Extensions
  4724.  
  4725.               Normally, when you type a filename (as opposed to an alias or
  4726.               internal command name) as the first word on the command line,
  4727.               4DOS looks for a .COM, .EXE, .BTM, or .BAT file with that name
  4728.               to execute (.COM and .EXE files are executable programs; .BTM
  4729.               and .BAT files are batch files).  You can add to this list of
  4730.               extensions and have 4DOS take the actions you want with files
  4731.               that have other extensions as well.  You could have 4DOS start
  4732.               your text editor whenever you type the name of a .DOC file, or
  4733.               start your database manager whenever you type the name of a
  4734.               .DAT file.
  4735.  
  4736.               4DOS uses environment variables to define what program or
  4737.               batch file to run for each defined file extension.  To create
  4738.               an executable extension, you use the SET command to create a
  4739.               new environment variable.
  4740.  
  4741.               For example, if you want to run a word processor called EDITOR
  4742.               whenever you type the name of a file that has an extension of
  4743.               .EDT, you could use this command:
  4744.  
  4745.                    c:\> set .edt=c:\edit\editor.exe
  4746.  
  4747.               The syntax for creating an executable extension is
  4748.  
  4749.                    set .ext=d:\path\program [options]
  4750.  
  4751.               where .EXT is the executable file extension, D:\PATH\PROGRAM
  4752.               is the full name of the program or batch file to run, and
  4753.               [options] are any command-line startup options you want to
  4754.               specify for the program.  The pathname is optional if the
  4755.               program is in a directory on your PATH.  The program to run
  4756.               must be a .COM, .EXE, .BTM, or .BAT file or an internal
  4757.               command.  It cannot be an alias.
  4758.  
  4759.               The following example defines BASICA.COM as the processor for
  4760.               .BAS files:
  4761.  
  4762.                    c:\> set .bas=c:\dos\basica.com
  4763.  
  4764.               With this definition, if you have a file named PUSHCART.BAS in
  4765.               the current directory and enter the command:
  4766.  
  4767.                    c:\> pushcart
  4768.  
  4769.               4DOS will execute the command:
  4770.  
  4771.  
  4772.  
  4773.           ___________________________________________________________________
  4774.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  76
  4775.  
  4776.                                                        CHAPTER 5 / USING 4DOS
  4777.           ___________________________________________________________________
  4778.  
  4779.  
  4780.                    c:\dos\basica.com pushcart
  4781.  
  4782.               The next example defines B.EXE (the Brief text editor) as the
  4783.               processor for .C files:
  4784.  
  4785.                    c:\> set .c=c:\brief\b.exe -Mxyz
  4786.  
  4787.               Now, if you have a file called HELLO.C and enter the command
  4788.  
  4789.                    c:\> hello -i30
  4790.  
  4791.               4DOS will expand the command line and execute this command:
  4792.  
  4793.                    c:\brief\b.exe -Mxyz hello.c -i30
  4794.  
  4795.               Notice that 4DOS inserts the value of the environment variable
  4796.               at the beginning of the line, including any options, then
  4797.               appends the original file name plus its extension, and then
  4798.               the remainder of the original command line.
  4799.  
  4800.               If the program you want to run doesn't accept a file name on
  4801.               its command line as shown in these examples, then executable
  4802.               extensions won't work with that program.
  4803.  
  4804.            ## 4DOS searches for executable commands in the following order:
  4805.               .COM, .EXE, .BTM, .BAT, and executable extensions in the order
  4806.               they appear in the environment.  It first searches the current
  4807.               directory, and then each subdirectory specified by the PATH
  4808.               environment variable (if a "." is used in the PATH the current
  4809.               directory is not searched first; see the PATH command on page
  4810.               276 for details).  4DOS recognizes environment variables as
  4811.               executable extensions if they begin with a period followed by
  4812.               1 to 3 valid filename characters.
  4813.  
  4814.               You may need to take this search order into account when using
  4815.               executable extensions.  Using the .BAS example above, if you
  4816.               had a file FORMAT.BAS in the current directory and entered the
  4817.               command FORMAT A:, 4DOS would run the BASIC interpreter
  4818.               specified by the executable extension, instead of finding the
  4819.               standard DOS FORMAT command as you intended.  You can get
  4820.               around this by remembering that the DOS FORMAT command is in
  4821.               the file FORMAT.COM.  If you entered the command FORMAT.COM A:
  4822.               then 4DOS would not find a match for the executable extension,
  4823.               and would continue the usual search sequence until it found
  4824.               the FORMAT command.
  4825.  
  4826.            ## Executable extensions may include wildcards, so you could, for
  4827.               example, have 4DOS run your text editor for any file with an
  4828.  
  4829.  
  4830.           ___________________________________________________________________
  4831.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  77
  4832.  
  4833.                                                        CHAPTER 5 / USING 4DOS
  4834.           ___________________________________________________________________
  4835.  
  4836.  
  4837.               extension beginning with T by defining an executable extension
  4838.               called .T*.  Extended wildcards (e.g. "DO[CT]" for .DOC and
  4839.               .DOT files) may also be used.
  4840.  
  4841.  
  4842.           The Environment
  4843.  
  4844.               The environment is a collection of information about your
  4845.               computer that every program receives.  You can view the
  4846.               environment by typing SET, and modify it with the ESET, SET,
  4847.               and UNSET commands (see pages 226, 302, and 320).
  4848.  
  4849.               Each entry in the environment consists of a variable name
  4850.               (usually in upper case) followed by an equal sign and a string
  4851.               of text.  Some variables are of general use to many programs;
  4852.               some are used only by one program or group of programs.  The
  4853.               content and form of the text string following the equal sign
  4854.               is defined by the program that uses each particular
  4855.               environment variable.  The text strings can be used from the
  4856.               4DOS command line, by application programs, and within aliases
  4857.               and batch files.
  4858.  
  4859.               The text string can include any characters except nulls (ASCII
  4860.               0).  The maximum length for the variable name, equal sign, and
  4861.               text string is 255 characters.
  4862.  
  4863.               4DOS can automatically substitute the text for the variable
  4864.               name in a command.  To create the substitution, include a
  4865.               percent sign [%] and a variable name on the command line or in
  4866.               an alias or batch file.  For example, if you create a variable
  4867.               named BACKUP like this:
  4868.  
  4869.                    c:\> set BACKUP=*.bak;*.bk!;*.bk
  4870.  
  4871.               and then type
  4872.  
  4873.                    c:\> del %BACKUP
  4874.  
  4875.               4DOS will execute the following command:
  4876.  
  4877.                    del *.bak;*.bk!;*.bk
  4878.  
  4879.            ## The variable names you use this way may contain any alphabetic
  4880.               or numeric characters, the underscore character [_], and the
  4881.               dollar sign [$].  You can force 4DOS to accept other
  4882.               characters by including the full variable name in square
  4883.               brackets, like this: %[AB##2].  You can also "nest"
  4884.               environment variables using square brackets.  For example
  4885.  
  4886.  
  4887.           ___________________________________________________________________
  4888.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  78
  4889.  
  4890.                                                        CHAPTER 5 / USING 4DOS
  4891.           ___________________________________________________________________
  4892.  
  4893.  
  4894.               %[%var1] means "the contents of the variable whose name is
  4895.               stored in VAR1".
  4896.  
  4897.            ## If you want to pass a percent sign, or a string beginning with
  4898.               a percent sign, to a command you must use two percent signs in
  4899.               a row.  Otherwise 4DOS will see your single percent sign as
  4900.               the beginning of a variable name, and will not pass it on to
  4901.               the command.  For example, to display the string "We're with
  4902.               you 100%", you would use the command:
  4903.  
  4904.                    echo We're with you 100%%
  4905.  
  4906.            ## If you embed an environment variable in the PROMPT, it must
  4907.               also be preceded by two percent signs, or the prompt text must
  4908.               be enclosed in back-quotes (see page 280 for details).
  4909.  
  4910.            ## Environment variables may be used to contain alias names.
  4911.               Normally 4DOS expands aliases before environment variables.
  4912.               However if you use an environment variable name (with a
  4913.               leading percent sign) as the first word in a command line,
  4914.               4DOS will substitute the variable value for the name, then
  4915.               check for any alias name which may have been included within
  4916.               the variable's value.  For example, the following commands
  4917.               would generate a 2-column directory of the .TXT files:
  4918.  
  4919.                    c:\> alias d2 dir /2
  4920.                    c:\> set cmd=d2
  4921.                    c:\> %cmd *.txt
  4922.  
  4923.            ## The trailing percent sign that was traditionally required for
  4924.               environment variable names is not usually required in 4DOS,
  4925.               which accepts any character that cannot be part of a variable
  4926.               name as the terminator.  However the trailing percent can be
  4927.               used to maintain compatibility.
  4928.  
  4929.               The trailing percent sign is needed if you want to concatenate
  4930.               two variable values.  The following examples show the possible
  4931.               interactions between variables and literal strings.  First,
  4932.               create two environment variables called ONE and TWO this way:
  4933.  
  4934.                    c:\> set ONE=abcd
  4935.                    c:\> set TWO=efgh
  4936.  
  4937.  
  4938.  
  4939.  
  4940.  
  4941.  
  4942.  
  4943.  
  4944.           ___________________________________________________________________
  4945.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  79
  4946.  
  4947.                                                        CHAPTER 5 / USING 4DOS
  4948.           ___________________________________________________________________
  4949.  
  4950.  
  4951.               Now the following combinations produce the output text shown:
  4952.  
  4953.                    %ONE%TWO             abcdTWO   ("%ONE%" + "TWO")
  4954.                    %ONE%TWO%            abcdTWO   ("%ONE%" + "TWO%")
  4955.                    %ONE%%TWO            abcdefgh  ("%ONE%" + "%TWO")
  4956.                    %ONE%%TWO%           abcdefgh  ("%ONE%" + "%TWO%")
  4957.                    %ONE%[TWO]           abcd[TWO] ("%ONE%" + "[TWO]")
  4958.                    %ONE%[TWO]%          abcd[TWO] ("%ONE%" + "[TWO]%")
  4959.                    %[ONE]%TWO           abcdefgh  ("%[ONE]" + "%TWO")
  4960.                    %[ONE]%TWO%          abcdefgh  ("%[ONE]" + "%TWO%")
  4961.  
  4962.  
  4963.               4DOS Configuration Variables
  4964.  
  4965.               The following environment variables have special meanings in
  4966.               4DOS.  Chapter 6 / Options and Fine Tuning (see page 116)
  4967.               explains the details of how to set and use each of them,
  4968.               except COLORDIR which is explained under the DIR and SELECT
  4969.               commands on pages 210 and 296.  You can see the current value
  4970.               of each variable, if it exists, with the SET command.
  4971.  
  4972.                    CDPATH tells 4DOS where to search for directories
  4973.                    specified by the CD and CDD commands and in automatic
  4974.                    directory changes.  _CDPATH can be used as an alternative
  4975.                    to CDPATH if you are using Microsoft Bookshelf, which
  4976.                    uses a CDPATH variable for its own purposes.
  4977.  
  4978.                    CMDLINE is the fully expanded text (up to 255 characters
  4979.                    long) of the currently executing 4DOS command line.  4DOS
  4980.                    sets CMDLINE just before it invokes any .COM, .EXE, .BTM,
  4981.                    or .BAT file.  If a command line is prefaced with an "@"
  4982.                    to prevent echoing (see page 57), 4DOS will not attempt
  4983.                    to put it in CMDLINE, and will remove any old CMDLINE
  4984.                    variable from the environment.  This allows you to
  4985.                    squeeze out the last few bytes of environment space
  4986.                    before loading TSRs by prefacing each TSR command with an
  4987.                    "@".
  4988.  
  4989.                    COLORDIR controls directory display colors used by DIR
  4990.                    and SELECT.
  4991.  
  4992.                    COMSPEC contains the full path and name of 4DOS itself.
  4993.                    COMSPEC is often used by applications which have a "shell
  4994.                    to DOS" feature.
  4995.  
  4996.                    PATH is a list of directories that 4DOS will search for
  4997.                    executable files that aren't in the current directory.
  4998.  
  4999.  
  5000.  
  5001.           ___________________________________________________________________
  5002.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  80
  5003.  
  5004.                                                        CHAPTER 5 / USING 4DOS
  5005.           ___________________________________________________________________
  5006.  
  5007.  
  5008.                    PATH may also be used by some application programs to
  5009.                    find their own files.
  5010.  
  5011.                    PROMPT defines the 4DOS command line prompt.
  5012.  
  5013.                    TEMP specifies the directory where 4DOS should store
  5014.                    temporary pipe files if the TEMP4DOS variable doesn't
  5015.                    exist.  Some other programs also use TEMP to define where
  5016.                    they should place their temporary files.
  5017.  
  5018.                    TEMP4DOS specifies where 4DOS should store temporary pipe
  5019.                    files.
  5020.  
  5021.  
  5022.               ## 4DOS Internal Variables
  5023.  
  5024.               The following variables are not actually stored in the
  5025.               environment, but can be used in commands, aliases, and batch
  5026.               files just like any other environment variable.  The values of
  5027.               these variables are stored internally in 4DOS and cannot be
  5028.               changed with the SET, UNSET, or ESET command.  However, you
  5029.               can override any of these variables by defining a new variable
  5030.               with the same name, which will be stored in the environment.
  5031.  
  5032.               These internal variables are often used in 4DOS batch files
  5033.               and aliases to examine system resources and adjust to the
  5034.               current computer settings.  You can examine the contents of
  5035.               any internal variable from the command line with a command
  5036.               like this:
  5037.  
  5038.                    c:\> echo %variablename
  5039.  
  5040.               In the list below, the possible values for most variables are
  5041.               shown in double quotes for ease of understanding.  The actual
  5042.               values returned by the variables do not include the double
  5043.               quotes.
  5044.  
  5045.               ? contains the exit code of the last external command.  Many
  5046.               programs return a 0 to indicate success and a non-zero value
  5047.               to signal an error.  However, not all programs return an exit
  5048.               code.  If no exit code is returned, the value of %? is
  5049.               undefined.
  5050.  
  5051.               _? contains the exit code of the last internal 4DOS command.
  5052.               It is set to 0 if the command was successful, non-zero if not.
  5053.               You must use or save this value immediately, because it is set
  5054.               by every internal command.
  5055.  
  5056.  
  5057.  
  5058.           ___________________________________________________________________
  5059.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  81
  5060.  
  5061.                                                        CHAPTER 5 / USING 4DOS
  5062.           ___________________________________________________________________
  5063.  
  5064.  
  5065.               _4VER is the current 4DOS version (for example, "4.0").
  5066.  
  5067.               _ALIAS contains the free space in the alias list, in bytes.
  5068.  
  5069.               _ANSI contains "1" if 4DOS's internal flags indicate that
  5070.               ANSI.SYS or a compatible driver is installed; "0" if not.  The
  5071.               internal flags which determine the value of _ANSI depend on
  5072.               the SETDOS /A option (see page 305) and the ANSI directive in
  5073.               4DOS.INI (see page 129), as shown in the table below.  If
  5074.               SETDOS /A is 0 or ANSI  is set to Auto, 4DOS tests for the
  5075.               presence of an ANSI driver.  Because there is no standard and
  5076.               100% reliable way to detect an ANSI driver, you may need to
  5077.               experiment to see if this variable works properly with your
  5078.               particular driver when 4DOS is allowed to test for its
  5079.               presence.
  5080.  
  5081.                                    ANSI
  5082.                    SETDOS /A       Directive      _ANSI Value
  5083.                    ------------    ------------   ------------
  5084.                     0 (default)    Auto (default) Result of test
  5085.                     1              Yes            1
  5086.                     2              No             0
  5087.  
  5088.               _BATCH is the current batch nesting level.  It is "0" if no
  5089.               batch file is currently being processed.
  5090.  
  5091.               _BG is a string containing the first three characters of the
  5092.               screen background color at the current cursor location (for
  5093.               example, "Bla").
  5094.  
  5095.               _BOOT is the boot drive letter, without a colon.
  5096.  
  5097.               _CODEPAGE is the current code page number (see CHCP on page
  5098.               193).
  5099.  
  5100.               _COLUMN is the current cursor column (for example, "0" for the
  5101.               left side of the screen).
  5102.  
  5103.               _COLUMNS is the current number of screen columns (for example,
  5104.               "80").
  5105.  
  5106.               _CPU is the cpu type, returned as a string:
  5107.  
  5108.                    86     8086 and 8088           286   80286
  5109.                    186    80186 and 80188         386   i386
  5110.                    200    NEC V20 and V30         486   i486
  5111.  
  5112.               _CWD is the current directory in the format d:\pathname.
  5113.  
  5114.  
  5115.           ___________________________________________________________________
  5116.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  82
  5117.  
  5118.                                                        CHAPTER 5 / USING 4DOS
  5119.           ___________________________________________________________________
  5120.  
  5121.  
  5122.               _CWDS has the same value as CWD, except it ends the pathname
  5123.               with a backslash [\].
  5124.  
  5125.               _CWP is the current directory in the format \pathname.
  5126.  
  5127.               _CWPS has the same value as CWP, except it ends the pathname
  5128.               with a backslash [\].
  5129.  
  5130.               _DATE contains the current system date, in the format mm-dd-yy
  5131.               (U.S.), dd-mm-yy (Europe), or yy-mm-dd (Japan).
  5132.  
  5133.               _DISK is the current disk drive, without a colon (for example,
  5134.               "C").
  5135.  
  5136.               _DOS is the operating system type ("DOS" or "OS2").  4DOS
  5137.               always returns "DOS", and 4OS2 always returns "OS2".  This is
  5138.               useful if you have batch files running in both modes.
  5139.  
  5140.               _DOSVER is the current DOS version (for example, "5.0").  In
  5141.               OS/2 DOS sessions the version number will be 10.2 for OS/2
  5142.               1.2, 10.3 for OS/2 1.3, 20.1 for OS/2 2.1, and so on.
  5143.  
  5144.               _DOW is the first three characters of the current day of the
  5145.               week ("Mon", "Tue", "Wed", etc.).
  5146.  
  5147.               _DV is "1" if DESQview is loaded or "0" otherwise.
  5148.  
  5149.               _ENV is the free space in the environment, in bytes.
  5150.  
  5151.               _FG is a string containing the first three letters of the
  5152.               screen foreground color at the current cursor position (for
  5153.               example, "Whi").
  5154.  
  5155.               _LASTDISK is the last valid drive letter, without a colon.
  5156.  
  5157.               _MONITOR is the monitor type ("mono" or "color").
  5158.  
  5159.               _MOUSE is 1 if a Microsoft-compatible mouse driver is loaded,
  5160.               and 0 otherwise.
  5161.  
  5162.               _NDP is the coprocessor type, returned as a string:
  5163.  
  5164.                    0      no coprocessor is installed
  5165.                    87     8087
  5166.                    287    80287
  5167.                    387    80387 or 80486DX
  5168.  
  5169.  
  5170.  
  5171.  
  5172.           ___________________________________________________________________
  5173.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  83
  5174.  
  5175.                                                        CHAPTER 5 / USING 4DOS
  5176.           ___________________________________________________________________
  5177.  
  5178.  
  5179.               _ROW is the current cursor row (for example, "0" for the top
  5180.               of the screen).
  5181.  
  5182.               _ROWS is the current number of screen rows (for example,
  5183.               "25").
  5184.  
  5185.               _SHELL is the current shell nesting level.  The primary shell
  5186.               is level "0", and each subsequent secondary shell increments
  5187.               the level by 1.
  5188.  
  5189.               _TIME contains the current system time in the format hh:mm:ss.
  5190.               The separator character may vary depending upon your country
  5191.               information  (see the CHCP command on page 193).
  5192.  
  5193.               _TRANSIENT is 1 if the current shell is transient (started
  5194.               with a /C), or 0 otherwise.
  5195.  
  5196.               _VIDEO is the video card type ("mono", "cga", "ega", or
  5197.               "vga").
  5198.  
  5199.               _WIN is the current Microsoft Windows mode.  This variable
  5200.               will always be zero except when 4DOS is running under
  5201.               Microsoft Windows:
  5202.  
  5203.                    0       Windows is not running
  5204.                    1       Windows 2
  5205.                    2       Windows 3 in 386 enhanced mode
  5206.                    3       Windows 3 in real or standard mode
  5207.  
  5208.               The _CWD, _CWDS, _CWP, _CWPS, and _DISK variables will return
  5209.               their result in upper or lower case depending on the value of
  5210.               the SETDOS /U switch (see page 305) or the UpperCase directive
  5211.               in 4DOS.INI (see page 132).  The _MONITOR and _VIDEO variables
  5212.               always return lower case.  The _BG, _DOW, and _FG variables
  5213.               return the first letter of the result in upper case and the
  5214.               rest in lower case.
  5215.  
  5216.               You can use these variables in a wide variety of ways
  5217.               depending on your needs.  Here are just a few examples.  Some
  5218.               of these examples rely on the IF command (page 245) or the IFF
  5219.               command (page 251) to test the value of a variable and perform
  5220.               different actions based on that value.
  5221.  
  5222.               In a batch file, set the color based on the video card type:
  5223.  
  5224.                    iff "%_video"=="mono" then
  5225.                      color bright white on black
  5226.                    else
  5227.  
  5228.  
  5229.           ___________________________________________________________________
  5230.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  84
  5231.  
  5232.                                                        CHAPTER 5 / USING 4DOS
  5233.           ___________________________________________________________________
  5234.  
  5235.  
  5236.                      color bright white on blue
  5237.                    endiff
  5238.  
  5239.               Call another batch file if 4DOS is running under DESQview:
  5240.  
  5241.                    if "%_dv" == "1" call dvstart
  5242.  
  5243.               Store the current date and time in a file, then save the
  5244.               output of a DIR command in the same file:
  5245.  
  5246.                    echo Directory as of %_date %_time > dirsave
  5247.                    dir >> dirsave
  5248.  
  5249.               Set up a prompt for the primary shell which displays the time
  5250.               and current directory, and a different one for secondary
  5251.               shells which includes the shell level rather than the time.
  5252.               Also set different background colors for the two shells,
  5253.               without changing the foreground color.  You might use a
  5254.               sequence like this in your 4START file, which is executed each
  5255.               time 4DOS starts:
  5256.  
  5257.                    iff %_shell==0 then
  5258.                      prompt $t $p$g
  5259.                      color %_fg on blue
  5260.                    else
  5261.                      prompt [$z] $p$g
  5262.                      color %_fg on cyan
  5263.                    endiff
  5264.  
  5265.  
  5266.               ## 4DOS Variable Functions
  5267.  
  5268.               Variable functions are like internal variables, but they take
  5269.               one or more arguments (which can be environment variables or
  5270.               even other variable functions), and they return a value.  Like
  5271.               all environment variables, these variable functions must be
  5272.               preceded by a percent sign in normal use (%@EVAL, %@LEN,
  5273.               etc.).  All variable functions must have square brackets
  5274.               enclosing their argument(s).  If you embed a variable function
  5275.               in the PROMPT it must be preceded by two percent signs, or the
  5276.               prompt text must be enclosed in back-quotes (see page 280 for
  5277.               details).
  5278.  
  5279.               The variable functions are useful in aliases and batch files
  5280.               to check on available system resources, manipulate strings and
  5281.               numbers, and work with filenames.  Some of the variable
  5282.               functions, like @DISKFREE, are shown with "b|k|m" as one of
  5283.  
  5284.  
  5285.  
  5286.           ___________________________________________________________________
  5287.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  85
  5288.  
  5289.                                                        CHAPTER 5 / USING 4DOS
  5290.           ___________________________________________________________________
  5291.  
  5292.  
  5293.               their arguments.  Those functions return a number of bytes,
  5294.               kilobytes, or megabytes based upon a "b|k|m" argument:
  5295.  
  5296.                    b     return the number of bytes
  5297.                    K     return the number of kilobytes (bytes / 1,024)
  5298.                    k     return the number of thousands of bytes (bytes /
  5299.                          1,000)
  5300.                    M     return the number of megabytes (bytes / 1,048,576)
  5301.                    m     return the number of millions of bytes (bytes /
  5302.                          1,000,000)
  5303.  
  5304.               @ALIAS[name]:  Returns the contents of the specified alias as
  5305.               a string, or a null string if the alias doesn't exist.
  5306.  
  5307.               @ASCII[c]:  Returns the numeric value of the specified ASCII
  5308.               character as a string.  For example %@ASCII[A] returns 65.
  5309.               You can put an escape character (Ctrl-X) before the actual
  5310.               character to process.  This allows quotes and other special
  5311.               characters as the argument (eg %@ASCII[^X`]).
  5312.  
  5313.               @ATTRIB[filename,attrib]:  Returns a "1" if the specified file
  5314.               has the matching attribute(s);  otherwise returns a "0".  The
  5315.               attributes are:
  5316.  
  5317.                    N     Normal (no attribute bits set)
  5318.                    R     Read-only
  5319.                    H     Hidden
  5320.                    S     System
  5321.                    D     Directory
  5322.                    A     Archive
  5323.  
  5324.               The attributes (other than N) can be combined;  ATTRIB will
  5325.               only return a 1 if all the attributes match.
  5326.  
  5327.               @CHAR[n]:  Returns the character corresponding to an ASCII
  5328.               numeric value.  For example %@CHAR[65] returns A.
  5329.  
  5330.               @DATE[mm-dd-yy]:  Returns the number of days since January 1,
  5331.               1980 for the specified date.  DATE uses the date format
  5332.               mandated by your country code (dd-mm-yy in Europe;  yy-mm-dd
  5333.               in Japan).
  5334.  
  5335.               @DESCRIPT[filename]:  Returns the file description for the
  5336.               specified filename (see the DESCRIBE command on page 208).
  5337.  
  5338.               @DEVICE[name]:  Returns 1 if the specified name is a character
  5339.               device (such as a printer or serial port), or 0 if not.
  5340.  
  5341.  
  5342.  
  5343.           ___________________________________________________________________
  5344.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  86
  5345.  
  5346.                                                        CHAPTER 5 / USING 4DOS
  5347.           ___________________________________________________________________
  5348.  
  5349.  
  5350.               @DISKFREE[d:,b|k|m]: Returns the amount of free disk space on
  5351.               the specified drive.
  5352.  
  5353.               @DISKTOTAL[d:,b|k|m]: Returns the total disk space on the
  5354.               specified drive.
  5355.  
  5356.               @DISKUSED[d:,b|k|m]: Returns the amount of disk space in use
  5357.               by files and directories on the specified drive.
  5358.  
  5359.               @DOSMEM[b|k|m]:  Returns the amount of free base memory.
  5360.  
  5361.               @EMS[b|k|m]:  Returns the amount of free EMS memory.
  5362.  
  5363.               @EVAL[expression]:  Evaluates an arithmetic expression.  @EVAL
  5364.               supports addition (+), subtraction (-), multiplication (*),
  5365.               division (/), and modulo (%%).  The expression can contain
  5366.               environment variables and other variable functions.  @EVAL
  5367.               also supports parentheses, commas, and decimal places.
  5368.               Parentheses can be nested.  The maximum number size is 16
  5369.               digits to the left of the decimal point and 8 digits to the
  5370.               right of the decimal point.  @EVAL will strip leading and
  5371.               trailing zeros from the result.  When evaluating expressions,
  5372.               *, /, and %% take precedence over + and -.  For example, 3 + 4
  5373.               * 2 will be interpreted as 3 + 8  = 11, not as (3 + 4) * 2 =
  5374.               14.  To change this order of evaluation, use parentheses to
  5375.               specify the order you want.
  5376.  
  5377.               @EXEC[command]:  Execute the command.  The command can be a
  5378.               4DOS alias, internal command, external command, .BTM file, or
  5379.               .BAT file.  This function is a "back-door" entry into 4DOS
  5380.               command processing and should be used with extreme caution.
  5381.               Incorrect or recursive use of @EXEC may cause stack overflows
  5382.               or hang your system.  @EXEC is primarily intended for running
  5383.               a program from within the PROMPT, where it should also be used
  5384.               with caution.
  5385.  
  5386.               @EXT[filename]:  Returns the extension from a file name,
  5387.               without a leading period.
  5388.  
  5389.               @EXTENDED[b|k|m]:  Returns the amount of extended memory.
  5390.  
  5391.               @FILEDATE[filename]:  Returns the date a file was last
  5392.               modified, in the default country format (mm-dd-yy for the US).
  5393.  
  5394.               @FILESIZE[filename,b|k|m]:  Returns the size of a file, or -1
  5395.               if the file does not exist.
  5396.  
  5397.  
  5398.  
  5399.  
  5400.           ___________________________________________________________________
  5401.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  87
  5402.  
  5403.                                                        CHAPTER 5 / USING 4DOS
  5404.           ___________________________________________________________________
  5405.  
  5406.  
  5407.               @FILETIME[filename]:  Returns the time a file was last
  5408.               modified, in hh:mm format.  The separator character will vary
  5409.               with the country definition in use on your system.
  5410.  
  5411.               @FULL[filename]:  Returns the fully qualified path name of a
  5412.               file.
  5413.  
  5414.               @INDEX[string1,string2]:  Returns the position of string2
  5415.               within string1, or "-1" if string2 is not found.  The first
  5416.               position in string1 is numbered 0.
  5417.  
  5418.               @INT[n]:  Returns the integer part of the number n.
  5419.  
  5420.               @LABEL[d:]:  Returns the volume label of the specified disk
  5421.               drive.
  5422.  
  5423.               @LEN[string]:  Returns the length of a string.
  5424.  
  5425.               @LINE[filename,n]:  Returns line "n" from the specified file.
  5426.               The first line in the file is numbered 0.  "**EOF**" is
  5427.               returned for all line numbers beyond the end of the file.
  5428.               @LINE will retrieve input from STDIN if you specify "con" as
  5429.               the filename.  If you are redirecting input to @LINE using
  5430.               this feature, you must use command grouping (see page 92)
  5431.               since redirection is normally performed AFTER variable
  5432.               functions are processed.  For example:
  5433.  
  5434.                    (echo %@line[con,0]) < myfile.dat
  5435.  
  5436.               @LINES[filename]:  Returns the line number of the last line in
  5437.               the file, or -1 if the file is empty.  The first line in the
  5438.               file is numbered 0, so (for example) @LINES will return 0 for
  5439.               a file containing one line.
  5440.  
  5441.               @LOWER[string]:  Returns the string converted to lower case.
  5442.  
  5443.               @LPT[n]:  Returns a "1" if the specified printer is ready;
  5444.               otherwise, returns "0".  n=1 checks the printer connected to
  5445.               LPT1, n=2 checks LPT2, and n=3 checks LPT3.
  5446.  
  5447.               @MAKEDATE[n]:  Returns a date (formatted according to the
  5448.               current country settings) from a number of days since 1/1/80.
  5449.               This is the opposite of @DATE.
  5450.  
  5451.               @MAKETIME[n]:  Returns a time (formatted according to the
  5452.               current country settings) from a number of seconds since
  5453.               midnight.  This is the opposite of @TIME.
  5454.  
  5455.  
  5456.  
  5457.           ___________________________________________________________________
  5458.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  88
  5459.  
  5460.                                                        CHAPTER 5 / USING 4DOS
  5461.           ___________________________________________________________________
  5462.  
  5463.  
  5464.               @NAME[filename]:  Returns the base name of a file, without the
  5465.               path or extension.
  5466.  
  5467.               @PATH[filename]:  Returns the path from a file name, including
  5468.               the drive letter and a trailing backslash but not including
  5469.               the base name or extension.
  5470.  
  5471.               @READSCR[row,col,length]:  Returns the text displayed on the
  5472.               screen at the specified location.  The first row and column on
  5473.               the screen are numbered 0.
  5474.  
  5475.               @READY[d:]:  Returns "1" if the specified drive is ready;
  5476.               otherwise returns "0".
  5477.  
  5478.               @REMOTE[d:]:  Returns "1" if the specified drive is a remote
  5479.               (network) drive; otherwise returns "0".
  5480.  
  5481.               @REMOVABLE[d:]:  Returns "1" if the specified drive is
  5482.               removable (i.e., a floppy disk or removable hard disk);
  5483.               otherwise returns "0".
  5484.  
  5485.               @SEARCH[filename]:  Searches for the filename using the PATH
  5486.               environment variable, appending an extension (.COM, .EXE,
  5487.               .BAT, .BTM, or executable extension) if one isn't specified.
  5488.               Returns the fully-expanded name of the file including drive,
  5489.               path, base name, and extension, or an empty string if a
  5490.               matching file is not found.  If wildcards are used in the
  5491.               filename, @SEARCH will search for the first file that matches
  5492.               the wildcard specification, and return the drive and path for
  5493.               that file plus the wildcard filename (e.g., E:\UTIL\*.COM).
  5494.  
  5495.               @SELECT[filename,top,left,bottom,right,title]:  Pops up a
  5496.               selection window with the lines from the specified file.
  5497.               Returns the text of the line the scrollbar is on if you press
  5498.               RETURN, or an empty string if you press ESCAPE.  @SELECT can
  5499.               be used to design menus or other selection lists from inside a
  5500.               batch file.  To select from lines passed through a pipe, use
  5501.               CON as the filename.
  5502.  
  5503.               @SUBSTR[string,start,length]:  Returns a substring, starting
  5504.               at the position "start" and continuing for "length"
  5505.               characters.  If the length is omitted, it will default to the
  5506.               remainder of the string.  If the length is negative, the start
  5507.               is relative to the right side of the string.  The first
  5508.               character in the string is numbered 0; if the length is
  5509.               negative, the last character is numbered 0.  For example,
  5510.               %@SUBSTR[%_time,0,2] gets the current time and extracts the
  5511.               hour.  If the string includes commas, it must be quoted with
  5512.  
  5513.  
  5514.           ___________________________________________________________________
  5515.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  89
  5516.  
  5517.                                                        CHAPTER 5 / USING 4DOS
  5518.           ___________________________________________________________________
  5519.  
  5520.  
  5521.               double quotes ["] or back-quotes [`].  The quotes do count in
  5522.               calculating the position of the substring to be extracted.
  5523.  
  5524.               @TIME[hh:mm:ss]:  Returns the number of seconds since midnight
  5525.               for the specified time.  The time must be in 24-hour format;
  5526.               "am" and "pm" cannot be used.
  5527.  
  5528.               @TRUENAME[filename]:  Returns the true, fully-expanded name
  5529.               for a file.  TRUENAME will see "through" a JOIN or SUBST, and
  5530.               requires DOS 3.0 or above.  Wildcards may not be used in the
  5531.               filename.
  5532.  
  5533.               @UNIQUE[d:\path]:  Creates a zero-length file with a unique
  5534.               name in the specified directory, and returns the full name and
  5535.               path.  If no path is specified, the file will be created in
  5536.               the current directory.  This function allows you to create a
  5537.               temporary file without overwriting an existing file.  @UNIQUE
  5538.               only works in DOS 3.0 and above.
  5539.  
  5540.               @UPPER[string]:  Returns the string converted to upper case.
  5541.  
  5542.               @WORD[n,string]:  Returns the "nth" word in a string.  The
  5543.               first word is numbered 0.  If "n" is negative, words are
  5544.               returned from the end of the string.  Only spaces, tabs, and
  5545.               commas are considered to be word separators.  For example:
  5546.  
  5547.                    %@WORD[2,NOW IS THE TIME]      returns "THE"
  5548.                    %@WORD[-0,NOW IS THE TIME]     returns "TIME"
  5549.                    %@WORD[-2,NOW IS THE TIME]     returns "IS"
  5550.  
  5551.               @XMS[b|k|m]:  Returns the amount of free XMS memory.
  5552.  
  5553.               You can use these variable functions in a wide variety of ways
  5554.               depending on your needs.  We've included a few examples below
  5555.               to give you an idea of what's possible.
  5556.  
  5557.               To set the prompt to show the amount of free base memory (see
  5558.               the PROMPT command, page 280,  for details on including
  5559.               variable functions in your prompt):
  5560.  
  5561.                    c:\> prompt (%%@dosmem[K]K) $p$g
  5562.  
  5563.               Set up a simple command line calculator.  The calculator is
  5564.               used with a command like CALC 3 * (4 + 5):
  5565.  
  5566.                    c:\> alias calc `echo The answer is:  %@eval[%&]`
  5567.  
  5568.  
  5569.  
  5570.  
  5571.           ___________________________________________________________________
  5572.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  90
  5573.  
  5574.                                                        CHAPTER 5 / USING 4DOS
  5575.           ___________________________________________________________________
  5576.  
  5577.  
  5578.               The following batch file uses variable functions to implement
  5579.               "once a day" execution of a group of commands.  It works by
  5580.               constructing a 6-digit number "yymmdd" from today's date, and
  5581.               comparing that to a number of the same type stored in the file
  5582.               C:\ONCEADAY.DAT.  If today's date is numerically larger than
  5583.               the saved date, and the time is after 6:00 AM, then the "once
  5584.               a day" commands are run, and today's date is saved in the file
  5585.               as the new date for comparison.  Otherwise, no action is
  5586.               taken.  You can make this file simpler using the %@DATE and
  5587.               %@TIME functions instead of using %@SUBSTR to extract
  5588.               substrings of the %_DATE and %_TIME variables; we used the
  5589.               approach shown to demonstrate the use of %@SUBSTR.
  5590.  
  5591.                   rem  Temporary variables used to shorten example lines:
  5592.                   rem    DD is _date, DY is yymmdd date, TM is _time
  5593.                   set dd=%_date
  5594.                   set dy=%@substr[%dd,6,2]%@substr[%dd,0,2]%@substr[%dd,3,2]
  5595.                   set lastdate=0
  5596.                   iff exist c:\onceaday.dat then
  5597.                     set lastdate=%@line[onceaday.dat,0]
  5598.                   endiff
  5599.                   iff %dy gt %lastdate then
  5600.                     set tm=%_time
  5601.                     iff "%@substr[%tm,0,2]%@substr[%tm,3,2]" gt "0600" then
  5602.                       rem Commands to be executed once a day go here
  5603.                       echo %dy > c:\onceaday.dat
  5604.                     endiff
  5605.                   endiff
  5606.  
  5607.  
  5608.           ## Advanced Features
  5609.  
  5610.               The next four 4DOS features are designed for advanced users of
  5611.               DOS and 4DOS.  If you are a novice user, you might want to
  5612.               skim over this section and return to it as your computing
  5613.               skills and needs progress.
  5614.  
  5615.  
  5616.               Conditional Commands
  5617.  
  5618.               When an internal command or external program finishes, it
  5619.               returns a result called the exit code.  4DOS's conditional
  5620.               commands allow you to perform tasks based upon the previous
  5621.               command's exit code.  Most programs return a 0 if they are
  5622.               successful and a non-zero value if they encounter an error.
  5623.  
  5624.               If you separate two commands by && (AND), the second command
  5625.               will be executed only if the first returns an exit code of 0.
  5626.  
  5627.  
  5628.           ___________________________________________________________________
  5629.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  91
  5630.  
  5631.                                                        CHAPTER 5 / USING 4DOS
  5632.           ___________________________________________________________________
  5633.  
  5634.  
  5635.               For example, the following command will only erase files if
  5636.               the BACKUP operation succeeds:
  5637.  
  5638.                    c:\> backup c:\ a: && del c:\*.bak;*.lst
  5639.  
  5640.               If you separate two commands by || (OR), the second command
  5641.               will be executed only if the first returns a non-zero exit
  5642.               code.  For example, if the following BACKUP operation fails,
  5643.               then ECHO will display a message:
  5644.  
  5645.                    c:\> backup c:\ a: || echo Error in the backup!
  5646.  
  5647.               All 4DOS internal commands return an explicit exit code, but
  5648.               not all application programs do.  Conditional commands will
  5649.               behave unpredictably if you use them with programs which do
  5650.               not return an explicit exit code.
  5651.  
  5652.  
  5653.               Command Grouping
  5654.  
  5655.               Command grouping allows you to logically group a set of
  5656.               commands together by enclosing them in parentheses.  The
  5657.               parentheses are similar in function to the BEGIN and END block
  5658.               statements in some programming languages.  Command grouping is
  5659.               a feature of the OS/2 command processor which 4DOS makes
  5660.               available to you under DOS as well.
  5661.  
  5662.               There are two primary uses for command grouping.  One is to
  5663.               execute multiple commands in a place where normally only a
  5664.               single command is allowed.  For example, suppose you want to
  5665.               copy then rename all the .WKQ files on drives A: and B: using
  5666.               the FOR command.  You could do it like this:
  5667.  
  5668.                    c:\> for %drv in (A B) do copy %drv:*.wkq d:\wksave\
  5669.                    c:\> for %drv in (A B) do ren %drv:*.wkq *.old
  5670.  
  5671.               But with command grouping you can do the same thing in one
  5672.               command (enter this on one line):
  5673.  
  5674.                    c:\> for %drv in (A B) do (copy %drv:*.wkq d:\wksave\ ^
  5675.                         ren %drv:*.wkq *.sav)
  5676.  
  5677.               The COPY and REN commands enclosed in the parentheses appear
  5678.               to FOR as if they were a single command, so both commands are
  5679.               executed for every element of the FOR list.
  5680.  
  5681.               This kind of command grouping is most useful with the EXCEPT,
  5682.               FOR, GLOBAL, and IF commands.  You can not use command
  5683.  
  5684.  
  5685.           ___________________________________________________________________
  5686.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  92
  5687.  
  5688.                                                        CHAPTER 5 / USING 4DOS
  5689.           ___________________________________________________________________
  5690.  
  5691.  
  5692.               grouping to make SELECT execute several commands, because
  5693.               SELECT will assume that the parentheses are marking the list
  5694.               of files from which to select, and will display an error
  5695.               message or give incorrect results if you try to use
  5696.               parentheses for command grouping instead.  (You can use a
  5697.               SELECT command inside the command grouping parentheses, you
  5698.               just can't use command grouping to specify a group of commands
  5699.               for SELECT to execute.)
  5700.  
  5701.               The second common use of command grouping is to redirect input
  5702.               or output for several commands without repeatedly using the
  5703.               redirection symbols.  For example, consider the following
  5704.               batch file fragment which places some header lines (including
  5705.               today's date) and directory displays in an output file using
  5706.               redirection.  The first ECHO command creates the file using >,
  5707.               and the other commands append to the file using >>:
  5708.  
  5709.                    echo Data files %_date > filelist
  5710.                    dir *.dat >> filelist
  5711.                    echo. >> filelist
  5712.                    echo Text files %_date >> filelist
  5713.                    dir *.txt >> filelist
  5714.  
  5715.               Using command grouping, these commands can be written much
  5716.               more simply (enter this on one line):
  5717.  
  5718.                    (echo Data files %_date ^ dir *.dat ^ echo. ^ echo Text
  5719.                    files %_date ^ dir *.txt) > filelist
  5720.  
  5721.               The redirection, which appears outside the parentheses,
  5722.               applies to all the commands within the parentheses.  The same
  5723.               approach can be used for input redirection and for piping.
  5724.  
  5725.               You can also use command grouping in a batch file or at the
  5726.               prompt to split commands over several lines.  This last
  5727.               example is like the redirection example above, but is entered
  5728.               at the prompt.  Note that 4DOS displays a "More? prompt after
  5729.               each incomplete line.  None of the commands are executed until
  5730.               the command group is completed with the closing parenthesis.
  5731.               This example does not have to be entered on one line:
  5732.  
  5733.                    c:\> (echo Data files %_date
  5734.                    More? dir *.dat
  5735.                    More? echo.
  5736.                    More? echo Text files %_date
  5737.                    More? dir *.txt) > filelist
  5738.                    c:\>
  5739.  
  5740.  
  5741.  
  5742.           ___________________________________________________________________
  5743.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  93
  5744.  
  5745.                                                        CHAPTER 5 / USING 4DOS
  5746.           ___________________________________________________________________
  5747.  
  5748.  
  5749.               A group of commands in parentheses is like a long command
  5750.               line.  The total length of the group may not exceed 511
  5751.               characters, whether the commands are entered from the prompt,
  5752.               an alias, or a batch file.  The 511-character limit includes
  5753.               the space required to expand aliases and environment variables
  5754.               invoked within the group.
  5755.  
  5756.  
  5757.               Escape Character
  5758.  
  5759.               4DOS recognizes a user-definable escape character.  This
  5760.               character gives the following character a special meaning;  it
  5761.               is not the same as the ASCII ESC that is often used in ANSI
  5762.               sequences.  The default 4DOS escape character is Ctrl-X (ASCII
  5763.               24), which will be displayed on your screen as an up arrow.
  5764.               (The escape character is shown below as "^X", but when
  5765.               entering it you must use the single keystroke Ctrl-X or ASCII
  5766.               24, not "^" followed by "X"!).  You can use the SETDOS /E
  5767.               command or the EscapeChar directive in 4DOS.INI to select a
  5768.               different escape character if you wish.
  5769.  
  5770.               4DOS recognizes six special characters if they are preceded by
  5771.               the escape character.  The combination of the escape character
  5772.               and one of these characters is translated to a single
  5773.               character by 4DOS, as shown below.  These are useful for
  5774.               redirecting codes to the printer; ^Xe is also useful to
  5775.               generate ANSI "escape sequences" in your PROMPT, ECHO, or
  5776.               other output commands; and ^Xr is used in keystroke aliases:
  5777.  
  5778.                    ^Xb   backspace
  5779.                    ^Xe   the ASCII ESC character (ASCII 27)
  5780.                    ^Xf   form feed
  5781.                    ^Xn   line feed
  5782.                    ^Xr   carriage return
  5783.                    ^Xt   tab character
  5784.  
  5785.               If you follow the escape character with any other character,
  5786.               the escape character is removed and the second character is
  5787.               copied directly to the command line.  This allows you to
  5788.               suppress the normal meaning of special characters (such as ? *
  5789.               / \ | " ` > < and &).
  5790.  
  5791.  
  5792.  
  5793.  
  5794.  
  5795.  
  5796.  
  5797.  
  5798.  
  5799.           ___________________________________________________________________
  5800.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  94
  5801.  
  5802.                                                        CHAPTER 5 / USING 4DOS
  5803.           ___________________________________________________________________
  5804.  
  5805.  
  5806.               For example, to send a form feed followed by the sequence ESC
  5807.               Y to the printer, you can use this command:
  5808.  
  5809.                    c:\> echos ^Xf^XeY > prn
  5810.  
  5811.  
  5812.               Argument Quoting
  5813.  
  5814.               When it begins to parse the command line, 4DOS looks for
  5815.               carets [^] to break the line into individual commands, for
  5816.               redirection symbols, and for white space (blanks, tabs, and
  5817.               commas) to separate commands from arguments.  It also looks
  5818.               for percent signs [%] which designate alias or batch file
  5819.               replaceable parameters (%1, %2, etc.), or environment
  5820.               variables, and substitutes the appropriate value for each
  5821.               variable (this process is called variable expansion).
  5822.               Normally, the separation characters and the percent sign
  5823.               cannot be passed to a command as part of an argument.
  5824.               However, you can include any of these special characters in an
  5825.               argument by enclosing the entire argument in back quotes [`]
  5826.               or double quotes ["].  Although both back quotes and double
  5827.               quotes will let you build arguments that include special
  5828.               characters, they do not work the same way.
  5829.  
  5830.               No alias or variable expansion will be performed on an
  5831.               argument enclosed in back quotes.  Redirection symbols inside
  5832.               the back quotes will be ignored.  The back quotes will be
  5833.               removed from the command line before the command is executed.
  5834.  
  5835.               No alias expansion will be performed on expressions enclosed
  5836.               in double quotes.  Redirection symbols inside double quotes
  5837.               will be ignored.  However, variable expansion will be
  5838.               performed on expressions inside double quotes.  The double
  5839.               quotes themselves will be passed through to the command as
  5840.               part of the argument.
  5841.  
  5842.               For example, suppose the batch file QUOTES.BAT contains the
  5843.               following commands:
  5844.  
  5845.                    @echo off
  5846.                    echo Arg1 = %1
  5847.                    echo Arg2 = %2
  5848.                    echo Arg3 = %3
  5849.  
  5850.               and that the environment variable FORVAR has been defined with
  5851.               this command:
  5852.  
  5853.                    c:\> set FORVAR=for
  5854.  
  5855.  
  5856.           ___________________________________________________________________
  5857.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  95
  5858.  
  5859.                                                        CHAPTER 5 / USING 4DOS
  5860.           ___________________________________________________________________
  5861.  
  5862.  
  5863.               Now, if you enter the command
  5864.  
  5865.                    c:\> quotes `Now is the time %forvar` all good
  5866.  
  5867.               the output from QUOTES.BAT will look like this:
  5868.  
  5869.                    Arg1 = Now is the time %forvar
  5870.                    Arg2 = all
  5871.                    Arg3 = good
  5872.  
  5873.               But if you enter the command
  5874.  
  5875.                    c:\> quotes "Now is the time %forvar" all good
  5876.  
  5877.               the output from QUOTES.BAT will look like this:
  5878.  
  5879.                    Arg1 = "Now is the time for"
  5880.                    Arg2 = all
  5881.                    Arg3 = good
  5882.  
  5883.               Notice that in both cases, the quotes keep characters together
  5884.               and reduce the number of arguments in the line.
  5885.  
  5886.               The following example has 7 command line arguments, while the
  5887.               examples above only have 3:
  5888.  
  5889.                    c:\> quotes Now is the time %forvar all good
  5890.  
  5891.               When an alias is defined in a batch file or from the command
  5892.               line, its argument should be enclosed in back quotes to
  5893.               prevent the expansion of replaceable parameters, variables,
  5894.               and multiple commands until the alias is invoked.  Back quotes
  5895.               should not be used when defining aliases to be read in an
  5896.               ALIAS /R file.
  5897.  
  5898.  
  5899.           Aliases
  5900.  
  5901.               Much of the power of 4DOS comes together in aliases, which
  5902.               give you the ability to create your own commands.  An alias is
  5903.               a name that you select for a command or group of commands.
  5904.               Simple aliases substitute a new name for an existing command.
  5905.               More complex aliases can redefine the default settings of 4DOS
  5906.               commands, operate as very fast in-memory batch files, and
  5907.               perform actions based on the results of other actions.
  5908.  
  5909.               This section of the manual will show you some examples of the
  5910.               power of aliases.  You can use these examples as the basis for
  5911.  
  5912.  
  5913.           ___________________________________________________________________
  5914.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  96
  5915.  
  5916.                                                        CHAPTER 5 / USING 4DOS
  5917.           ___________________________________________________________________
  5918.  
  5919.  
  5920.               your own aliases.  See the ALIAS command (page 173) for
  5921.               complete details about writing your own aliases.
  5922.  
  5923.               The simplest type of alias gives a new name to an existing
  5924.               command.  For example, you could create a command called ROOT
  5925.               to switch to the root directory this way:
  5926.  
  5927.                    c:\> alias root = `cd \`
  5928.  
  5929.               After the alias has been defined this way, every time you type
  5930.               the command ROOT, 4DOS will execute the command CD \.
  5931.  
  5932.               Aliases can also create customized versions of 4DOS commands.
  5933.               For example, the 4DOS DIR command can sort a directory in
  5934.               various ways.  You can create an alias called DE that means
  5935.               "sort the directory by filename extension, and pause after
  5936.               each page while displaying it" like this:
  5937.  
  5938.                    c:\> alias de = `dir /oe /p`
  5939.  
  5940.               Aliases can be used to execute sequences of commands as well.
  5941.               The following command creates an alias called W which saves
  5942.               the current drive and directory, changes to the WP directory
  5943.               on drive C, runs the program E:\WP51\WP.EXE, and, when the
  5944.               program terminates, returns to the original drive and
  5945.               directory:
  5946.  
  5947.                    c:\> alias w = `pushd c:\wp ^ e:\wp51\wp.exe ^ popd`
  5948.  
  5949.               Aliases can be nested, that is, one alias can invoke another.
  5950.               For example, the alias above could also be written as:
  5951.  
  5952.                    c:\> alias wp = `e:\wp51\wp.exe`
  5953.                    c:\> alias w = `pushd c:\wp ^ wp ^ popd`
  5954.  
  5955.               If you enter the W command, 4DOS will execute the PUSHD
  5956.               command, detect that the next command (WP) is another alias,
  5957.               execute the program E:\WP51\WP.EXE, and -- when the program
  5958.               exits -- return to the first alias, execute the POPD command,
  5959.               and finally return to the prompt.
  5960.  
  5961.               You can use aliases to change the default options for both
  5962.               internal 4DOS commands and external commands.  Suppose that
  5963.               you always want the DEL command to prompt before it erases a
  5964.               file:
  5965.  
  5966.                    c:\> alias del = `*del /p`
  5967.  
  5968.  
  5969.  
  5970.           ___________________________________________________________________
  5971.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  97
  5972.  
  5973.                                                        CHAPTER 5 / USING 4DOS
  5974.           ___________________________________________________________________
  5975.  
  5976.  
  5977.               You may have a program on your system that has the same name
  5978.               as an internal 4DOS command.  Normally, 4DOS will run the
  5979.               internal command and not let you run the program you desire,
  5980.               unless you explicitly add its full path on the command line
  5981.               (type C:\UTIL\LIST.COM, for example).  Aliases give you two
  5982.               ways to get around this problem.
  5983.  
  5984.               First, you could define an alias that runs the program in
  5985.               question, but with a different name.  For example, if you want
  5986.               to run a program called HELP.EXE when you type HLP, this alias
  5987.               will do the trick:
  5988.  
  5989.                    c:\> alias hlp = `c:\dos\help.exe`
  5990.  
  5991.               Another approach you could take would be to rename the
  5992.               internal 4DOS command and use the original name for the
  5993.               external program.  The following example renames the 4DOS LIST
  5994.               command as DISPLAY and then uses a second alias to run
  5995.               LIST.COM whenever you type LIST:
  5996.  
  5997.                    c:\> alias display = `*list`
  5998.                    c:\> alias list = `c:\util\list.com`
  5999.  
  6000.               You can also assign an alias to a key, so that every time you
  6001.               press the key, the command will be invoked.  After you enter
  6002.               this next example, 4DOS will display a 2-column directory with
  6003.               paging whenever you press Shift plus F5:
  6004.  
  6005.                    c:\> alias @Shift-F5 = `*dir /2/p`
  6006.  
  6007.               That example will put the DIR command on the command line when
  6008.               you press F5 and wait for you to enter file names to display
  6009.               and then press Enter.  This next example clears the screen
  6010.               whenever you press Alt-F1.  The "^X" is the 4DOS escape
  6011.               character (see page 94), which you enter by pressing Ctrl-X
  6012.               (it is entered twice before the r at the end of this alias):
  6013.  
  6014.                    c:\> alias @Alt-F1 = `cls^X^Xr`
  6015.  
  6016.               Aliases have many other capabilities as well.  This example
  6017.               creates a simple command-line calculator.  Once you have
  6018.               entered the example, you can type CALC 4*19, for example, and
  6019.               4DOS will display the answer:
  6020.  
  6021.                    c:\> alias calc = `echo The answer is:  %@eval[%&]`
  6022.  
  6023.               Our last example in this section creates an alias called IN.
  6024.               It will temporarily change directories, run an internal or
  6025.  
  6026.  
  6027.           ___________________________________________________________________
  6028.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  98
  6029.  
  6030.                                                        CHAPTER 5 / USING 4DOS
  6031.           ___________________________________________________________________
  6032.  
  6033.  
  6034.               external command, and then return to the current directory
  6035.               when the command is finished:
  6036.  
  6037.                    c:\> alias in = `pushd %1 ^ %2& ^ popd`
  6038.  
  6039.               Now if you type
  6040.  
  6041.                    c:\> in c:\letters wp letter.txt
  6042.  
  6043.               4DOS will change to the C:\LETTERS subdirectory, execute the
  6044.               command WP LETTER.TXT and then return to the current
  6045.               directory.
  6046.  
  6047.               The distribution diskette includes a sample alias file called
  6048.               ALIASES which contains several useful aliases and demonstrates
  6049.               many alias techniques.  Also, see the ALIAS and UNALIAS
  6050.               commands on pages 173 and 319 for more information and
  6051.               examples.  See page 103 for tips about using aliases inside
  6052.               your batch files.
  6053.  
  6054.  
  6055.           Batch Files
  6056.  
  6057.               A batch file is a file that contains a list of commands for
  6058.               4DOS to execute.  4DOS reads and interprets each line as if it
  6059.               had been typed at the keyboard.  Like aliases, batch files are
  6060.               handy for automating computing tasks.  Unlike aliases, batch
  6061.               files can be as long as you wish.  Batch files take up
  6062.               separate disk space for each file, and can't usually execute
  6063.               quite as quickly as aliases, since they must be read from the
  6064.               disk.
  6065.  
  6066.  
  6067.               .BAT Files and .BTM Files
  6068.  
  6069.               4DOS can execute a batch file in two different modes.  In the
  6070.               first, traditional mode, 4DOS reads and executes the lines of
  6071.               the batch file individually.  In the second mode, 4DOS reads
  6072.               the entire batch file into memory at once.  The second mode
  6073.               can be 5 to 10 times faster, especially if most of the
  6074.               commands in the batch file are internal 4DOS commands.
  6075.               However, only the first mode can be used for self-modifying
  6076.               batch files (which are rare), for batch files which install
  6077.               memory-resident utilities, and for batch files larger than 64K
  6078.               bytes.
  6079.  
  6080.               4DOS decides which batch file mode to use by the file's
  6081.               extension.  It runs files with a .BAT extension in the slower,
  6082.  
  6083.  
  6084.           ___________________________________________________________________
  6085.           Copyright 1993, JP Software Inc.       4DOS Reference Manual  /  99
  6086.  
  6087.                                                        CHAPTER 5 / USING 4DOS
  6088.           ___________________________________________________________________
  6089.  
  6090.  
  6091.               traditional mode.  Files that have a .BTM extension are run in
  6092.               the faster, more efficient mode.  You can change the execution
  6093.               mode inside of a batch file (of either type) with the LOADBTM
  6094.               command (see page 266).
  6095.  
  6096.  
  6097.               Echoing
  6098.  
  6099.               By default, 4DOS displays or "echoes" every batch file line as
  6100.               it is executed.  You can change this behavior, if you want, in
  6101.               several different ways:
  6102.  
  6103.                    Any batch file line that begins with an [@] symbol will
  6104.                    not be displayed.
  6105.  
  6106.                    The display can be turned off and on within a batch file
  6107.                    with the ECHO OFF and ECHO ON commands.
  6108.  
  6109.                    The default setting can be changed with the SETDOS /V
  6110.                    command (see page 305) or the BatchEcho directive in
  6111.                    4DOS.INI (see page 129).
  6112.  
  6113.               For example, the following line turns off echoing inside a
  6114.               batch file.  The [@] symbol keeps the batch file from
  6115.               displaying the ECHO OFF command:
  6116.  
  6117.                    @echo off
  6118.  
  6119.               4DOS also has a command line echo that is unrelated to the
  6120.               batch file echo setting.  See the ECHO command on page 222 for
  6121.               details about both settings.
  6122.  
  6123.  
  6124.               Batch File Variables
  6125.  
  6126.               Like aliases and application programs, batch files can examine
  6127.               the command line that is used to invoke them.  4DOS separates
  6128.               the command tail (everything on the command line after the
  6129.               batch file name) into individual parameters or variables by
  6130.               scanning for the spaces, tabs, and commas that separate the
  6131.               parameters.  A batch file can work with individual parameters
  6132.               or with the command tail as a whole.
  6133.  
  6134.               4DOS numbers these replaceable parameters from %1 to %127.  It
  6135.               is up to the batch file to determine the meaning of each
  6136.               parameter.  Parameters that are referred to in a batch file,
  6137.               but which are missing on the command line, appear as empty
  6138.               strings inside the batch file.
  6139.  
  6140.  
  6141.           ___________________________________________________________________
  6142.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  100
  6143.  
  6144.                                                        CHAPTER 5 / USING 4DOS
  6145.           ___________________________________________________________________
  6146.  
  6147.  
  6148.               A batch file can also work with three special parameters: %0
  6149.               contains the name of the batch file as it was entered on the
  6150.               command line, %# contains the number of command-line
  6151.               arguments, and %n& contains the complete command line tail
  6152.               starting with argument number "n".  The default value of "n"
  6153.               is 1, so %& contains the entire command tail.  The values of
  6154.               these special parameters can change if you use the SHIFT
  6155.               command (see page 310).
  6156.  
  6157.               For example, suppose the batch file interprets the first
  6158.               argument as a subdirectory name.  Then the following line
  6159.               would move to the specified directory:
  6160.  
  6161.                    cd %1
  6162.  
  6163.               A friendlier batch file would check to make sure the directory
  6164.               exists and take some special action if it doesn't:
  6165.  
  6166.                    iff isdir %1 then ^ cd %1
  6167.                    else ^ echo Subdirectory %1 does not exist ^ quit
  6168.                    endiff
  6169.  
  6170.               (see the IF and IFF commands on pages 245 and 251).
  6171.  
  6172.            ## Batch files can also use environment variables, internal
  6173.               variables, and variable functions.  See pages 81 - 91 for a
  6174.               complete list of the internal variables and variable functions
  6175.               available.  You can use these variables and functions to
  6176.               determine system status (e.g., the type of CPU in the system),
  6177.               resource levels (e.g., the amount of free disk space), file
  6178.               information (e.g., the date and time  a file was last
  6179.               modified) and other information (e.g., the current date and
  6180.               time).  You can also perform arithmetic (including date
  6181.               arithmetic), manipulate strings and substrings, extract parts
  6182.               of a filename, and perform simple file access.
  6183.  
  6184.            ## To create temporary variables for use inside a batch file,
  6185.               just use the SET command to store the information you want in
  6186.               an environment variable.  Pick a variable name that isn't
  6187.               likely to be in use by some other program (for example, PATH
  6188.               would be a bad choice), and use the UNSET command (page 320)
  6189.               to remove these variables from the environment at the end of
  6190.               your batch file.  You can also use SETLOCAL and ENDLOCAL
  6191.               (pages 309 and 225) to create a "local" environment so that
  6192.               the original environment will be restored when your batch file
  6193.               is finished.
  6194.  
  6195.  
  6196.  
  6197.  
  6198.           ___________________________________________________________________
  6199.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  101
  6200.  
  6201.                                                        CHAPTER 5 / USING 4DOS
  6202.           ___________________________________________________________________
  6203.  
  6204.  
  6205.            ## Environment variables used in a batch file may contain either
  6206.               numbers or text.  It is up to you to keep track of what's in
  6207.               each variable and use it appropriately; if you don't (for
  6208.               example, if you use %@EVAL to add a number to a text string),
  6209.               you'll get an error message.
  6210.  
  6211.            ## Be careful not to confuse the various kinds of variables that
  6212.               4DOS provides.  Replaceable parameters, environment variables,
  6213.               internal variables, and variable functions look similar and
  6214.               have similar uses but they are not the same.
  6215.  
  6216.  
  6217.               Batch File Commands
  6218.  
  6219.               Several 4DOS commands are particularly suited to batch file
  6220.               processing.  Each command is explained in detail in the
  6221.               Command Reference section of this manual, beginning on page
  6222.               166.  Here is a list of some of the commands you might find
  6223.               most useful:
  6224.  
  6225.                    BEEP produces a sound of any pitch and duration through
  6226.                    the computer's speaker.
  6227.  
  6228.                    CALL executes one batch file from within another.
  6229.  
  6230.                    CANCEL terminates all batch file processing.
  6231.  
  6232.                    CLS and COLOR set the screen display colors.
  6233.  
  6234.                    DRAWBOX draws a box on the screen.
  6235.  
  6236.                    DRAWHLINE and DRAWVLINE draw horizontal and vertical
  6237.                    lines on the screen.
  6238.  
  6239.                    ECHO and ECHOS print text on the screen (the text can be
  6240.                    redirected to a file or device).
  6241.  
  6242.                    GOSUB executes a subroutine inside a batch file.  The
  6243.                    RETURN command terminates the subroutine.
  6244.  
  6245.                    GOTO branches to a different location in the batch file.
  6246.  
  6247.                    FOR executes commands for each file that matches a set of
  6248.                    wildcards, or each entry in a list.
  6249.  
  6250.                    IF and IFF execute commands based on a test of string or
  6251.                    numeric values, program exit codes, or other conditions.
  6252.  
  6253.  
  6254.  
  6255.           ___________________________________________________________________
  6256.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  102
  6257.  
  6258.                                                        CHAPTER 5 / USING 4DOS
  6259.           ___________________________________________________________________
  6260.  
  6261.  
  6262.                    INKEY and INPUT collect keyboard input from the user and
  6263.                    store it in environment variables.
  6264.  
  6265.                    KEYSTACK places keystrokes into the 4DOS Keystack.
  6266.  
  6267.                    LOADBTM changes the batch file operating mode.
  6268.  
  6269.                    PAUSE displays a message and waits for the user to press
  6270.                    a key.
  6271.  
  6272.                    QUIT ends the current batch file and optionally returns
  6273.                    an exit code.
  6274.  
  6275.                    REM places a remark in a batch file.
  6276.  
  6277.                    SCREEN positions the cursor on the screen and optionally
  6278.                    prints a message at the new location.
  6279.  
  6280.                    SCRPUT displays a message in color.
  6281.  
  6282.                    SETLOCAL saves the current disk drive, default directory,
  6283.                    environment, and alias list.  ENDLOCAL restores the
  6284.                    settings that were saved.
  6285.  
  6286.                    SHIFT changes the numbering of the replaceable
  6287.                    parameters.
  6288.  
  6289.                    TEXT displays a block of text.  ENDTEXT ends the block.
  6290.  
  6291.                    TIMER starts or reads a stopwatch.
  6292.  
  6293.                    VSCRPUT displays a vertical message in color.
  6294.  
  6295.               These commands, along with the 4DOS internal variables and
  6296.               variable functions, make the 4DOS batch file language
  6297.               extremely powerful.  The distribution diskette contains a
  6298.               number of sample batch files that demonstrate some of the
  6299.               things you can do with 4DOS batch files.
  6300.  
  6301.  
  6302.               ## Batch File Tips
  6303.  
  6304.               This section gives you some tips on batch file programming,
  6305.               including a few things we've found useful and a few that you
  6306.               should stay away from.
  6307.  
  6308.               One way to simplify batch file programming is to use aliases.
  6309.               Not aliases that can be used from the command line, but
  6310.  
  6311.  
  6312.           ___________________________________________________________________
  6313.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  103
  6314.  
  6315.                                                        CHAPTER 5 / USING 4DOS
  6316.           ___________________________________________________________________
  6317.  
  6318.  
  6319.               aliases that hide unnecessary detail inside a batch file.  For
  6320.               example, suppose you want to implement a multiple choice list
  6321.               in a batch file that will let you select among several
  6322.               different applications.  This example shows one way to do so:
  6323.  
  6324.                    alias in `pushd %1 ^ %2& ^ popd`
  6325.                    alias choice `elseiff "%userchoice"=="%1" then`
  6326.                    :dispmenu
  6327.                    screen 8 0
  6328.                    text
  6329.                     Enter your choice:
  6330.                          1. Word Processing
  6331.                          2. Spreadsheet
  6332.                          3. Communications
  6333.                    endtext
  6334.                    inkey %%userchoice
  6335.                    iff "1"=="2" then ^ rem  Always fail and go to next line
  6336.                    choice 1 ^ in d:\letters  c:\wp51\wp.exe
  6337.                    choice 2 ^ in d:\finance  c:\quattro\q.exe
  6338.                    choice 3 ^ in d:\comm  c:\comsw\pcplus.exe
  6339.                    else
  6340.                      scrput 23 0 bri whi on red Invalid choice, try again
  6341.                      goto dispmenu
  6342.                    endiff
  6343.  
  6344.               The first alias, IN, expects 2 or more command-line arguments.
  6345.               It uses the first as a new working directory and changes to
  6346.               that directory with a PUSHD command.  The rest of the command
  6347.               line is interpreted as the name of an application program plus
  6348.               possible command line parameters, which the alias executes.
  6349.               This alias could be used from the command line.
  6350.  
  6351.               The second alias, CHOICE, expects 1 command line argument.  It
  6352.               tests whether an environment variable called userchoice has
  6353.               the same value as the command line argument.  But the test
  6354.               comes between ELSEIFF and THEN statements.  If you try to use
  6355.               CHOICE from the command line, 4DOS will generate an error
  6356.               because it will see ELSEIFF and THEN without the necessary IFF
  6357.               and ENDIFF to define a block.
  6358.  
  6359.               The next 9 lines print a menu on the screen and then get a
  6360.               keystroke from the user and store the keystroke in an
  6361.               environment variable called userchoice.  Then the batch file
  6362.               tests the user's keystroke to decide what action to take.
  6363.  
  6364.               Since the CHOICE alias starts with an ELSEIFF command, there
  6365.               has to be an IFF.  But the first condition must fail in order
  6366.               to get to the CHOICE aliases, so the IFF statement starts with
  6367.  
  6368.  
  6369.           ___________________________________________________________________
  6370.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  104
  6371.  
  6372.                                                        CHAPTER 5 / USING 4DOS
  6373.           ___________________________________________________________________
  6374.  
  6375.  
  6376.               a condition that will always be false.  The three lines after
  6377.               the IFF are easy to follow and much shorter than they would be
  6378.               without the aliases.  If it had to be typed in full, the first
  6379.               choice line would look like this:
  6380.  
  6381.                    elseiff "%userchoice"=="1" then pushd d:\letters ^
  6382.                    c:\wp\wp51.exe ^ popd
  6383.  
  6384.               There's another side to aliases in batch files.  If you're
  6385.               going to distribute your 4DOS batch files to others, you need
  6386.               to remember that they may have aliases defined for the
  6387.               commands you're going to use.  For example if the user has
  6388.               aliased CD to CDD and you aren't expecting this, your file may
  6389.               not work as you intended.  There are two ways to address this
  6390.               problem.  First, you can use SETLOCAL, ENDLOCAL, and UNALIAS
  6391.               to clear out aliases before your batch file starts and restore
  6392.               them at the end.  For example:
  6393.  
  6394.                    setlocal
  6395.                    unalias *
  6396.                    rem Aliases cleared, set up new aliases
  6397.                    alias ...
  6398.                    rem Other batch file commands go here
  6399.                    endlocal
  6400.  
  6401.               Remember that SETLOCAL and ENDLOCAL will save and restore not
  6402.               only the aliases but also the environment and the current
  6403.               drive and directory.
  6404.  
  6405.               If this method isn't appropriate or necessary for the batch
  6406.               file you're working on, you can also use an asterisk [*]
  6407.               before the name of any command.  The asterisk tells 4DOS not
  6408.               to interpret the command that follows it as an alias.  For
  6409.               example the following command redirects a list of file names
  6410.               to the file FILELIST:
  6411.  
  6412.                    dir /b > filelist
  6413.  
  6414.               However if the user has redefined DIR with an alias this
  6415.               command may not do what you want.  To get around this just
  6416.               use:
  6417.  
  6418.                    *dir /b > filelist
  6419.  
  6420.               The same can be done for any command in your batch file.  If
  6421.               you use the asterisk, 4DOS will skip alias processing, discard
  6422.               the asterisk, and process the rest of the command normally as
  6423.               an internal command, external command, or batch file.  Using
  6424.  
  6425.  
  6426.           ___________________________________________________________________
  6427.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  105
  6428.  
  6429.                                                        CHAPTER 5 / USING 4DOS
  6430.           ___________________________________________________________________
  6431.  
  6432.  
  6433.               an asterisk before a command will work whether or not there is
  6434.               actually an alias defined with the same name as the command.
  6435.               If there is no alias with that name, the asterisk will be
  6436.               ignored and the command will be processed as if the asterisk
  6437.               wasn't there.
  6438.  
  6439.               There are several tricks you can use in debugging batch files.
  6440.               Probably the simplest is to turn ECHO on at the beginning of
  6441.               the file while you're testing it, or use SETDOS /V2 to force
  6442.               echo on even if an ECHO OFF command is used in the batch file.
  6443.               This will give you a picture of what 4DOS is doing when it
  6444.               executes the file.  It will make your output look messy of
  6445.               course, so just turn it off once things are working.  You can
  6446.               also turn ECHO on at the beginning of a group of commands you
  6447.               want to "watch", and off at the end, just by adding ECHO
  6448.               commands at the appropriate spots in your file.
  6449.  
  6450.               Another trick is to insert PAUSE commands wherever you need
  6451.               them in order to be able to watch what's happening.  For
  6452.               complex debugging, you can make an alias that uses INKEY for a
  6453.               similar purpose, but helps you out a little more.  For example
  6454.               (enter this on one line):
  6455.  
  6456.                    alias step `set skey=^inkey Step:  %%skey^iff
  6457.                    "%skey"=="S" then ^ set /P ^ elseiff "%skey"=="X" then ^
  6458.                    quit ^ endiff`
  6459.  
  6460.               Now anywhere you insert a STEP command in your file you'll get
  6461.               the Step: prompt during execution.  At that point you can type
  6462.               S to do a SET /P and display the current contents of your
  6463.               environment variables, X to exit the batch file, and any other
  6464.               key to go on.  Of course you'll need to create an alias
  6465.               tailored to your particular needs, but this gives you the
  6466.               basic idea.
  6467.  
  6468.               If you can't figure out how 4DOS is expanding your aliases and
  6469.               variables, try turning LOG on at the start of the batch file.
  6470.               LOG keeps track of all commands after alias and variable
  6471.               expansion  are completed, and gives you a record in a file
  6472.               that you can examine after the batch file is done.
  6473.  
  6474.               You may also want to consider using redirection to capture
  6475.               your batch file output.  Simply type the batch file name
  6476.               followed by the redirection symbols, for example:
  6477.  
  6478.                    c:\> mybatch >& testout
  6479.  
  6480.  
  6481.  
  6482.  
  6483.           ___________________________________________________________________
  6484.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  106
  6485.  
  6486.                                                        CHAPTER 5 / USING 4DOS
  6487.           ___________________________________________________________________
  6488.  
  6489.  
  6490.               This records all batch file output, including error messages,
  6491.               in the file TESTOUT, so you can go back and examine it.  If
  6492.               you have ECHO ON in the batch file you'll get the batch
  6493.               commands intermingled with the output, which can provide a
  6494.               very useful trace of what's happening.  Of course output from
  6495.               full-screen commands and programs that don't write to the
  6496.               standard DOS output devices can't be recorded, but you can
  6497.               still gain a lot of useful information if your batch file does
  6498.               much output.
  6499.  
  6500.               If you're using redirection to see the output, remember that
  6501.               any prompts for input will probably go to the output file and
  6502.               not to the screen, so you need to know in advance the sequence
  6503.               of keystrokes required to get through the entire batch file,
  6504.               and enter them by hand or with KEYSTACK.  (As an example, the
  6505.               raw text for the 4DOS tour in this manual was created by
  6506.               writing a batch file containing the demonstration commands,
  6507.               testing it to get the proper keystroke sequence, and executing
  6508.               a command which used KEYSTACK to send the keystrokes and
  6509.               redirected the batch file's output to a disk file.)
  6510.  
  6511.               Because of the power of the 4DOS batch language, some
  6512.               programmers begin to treat it as a full, general-purpose
  6513.               language.  But the batch language is interpreted one line at a
  6514.               time, which can lead the unwary into some subtle traps.
  6515.  
  6516.               In particular, the IFF and GOTO instructions may not work
  6517.               together as many programmers expect.  4DOS has no way of
  6518.               telling whether a GOTO is branching within the same IFF block,
  6519.               into another IFF block, or out of all IFF blocks, so it has to
  6520.               make an assumption.  It assumes that the branch is leaving the
  6521.               IFF block and it therefore cancels all pending IFF processing.
  6522.               For example, the following commands will NOT work:
  6523.  
  6524.                    iff "%_monitor" == "color" then
  6525.                      iff %@diskfree[c:,K] gt 100 then
  6526.                        set var1=Y
  6527.                        goto point1
  6528.                      else
  6529.                        set var1=N
  6530.                      endiff
  6531.                    else
  6532.                      :point1
  6533.                      rem  do something else here
  6534.                    endiff
  6535.  
  6536.               If the GOTO in the 4th line is executed, the commands after
  6537.               :POINT1 will execute properly.  But 4DOS will generate an
  6538.  
  6539.  
  6540.           ___________________________________________________________________
  6541.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  107
  6542.  
  6543.                                                        CHAPTER 5 / USING 4DOS
  6544.           ___________________________________________________________________
  6545.  
  6546.  
  6547.               error message when it reaches the last ENDIFF, because it
  6548.               assumed that the GOTO branched outside of all IFF blocks.  You
  6549.               can override this restriction with GOTO /I, but do so only if
  6550.               you are absolutely certain that your GOTO command is branching
  6551.               entirely within the current active IFF statement, and not into
  6552.               another IFF statement or a different IFF nesting level.  Using
  6553.               /I under any other conditions will cause an error later in
  6554.               your batch file.
  6555.  
  6556.               Because the IFF state is saved whenever a GOSUB occurs or
  6557.               whenever another batch file is CALLed, GOTO only cancels IFF
  6558.               processing within the current subroutine or batch file.  This
  6559.               allows you to use GOTO inside a subroutine without affecting
  6560.               any IFF blocks that surround the GOSUB statement which called
  6561.               the subroutine.
  6562.  
  6563.               GOSUB and GOTO can also have unexpected consequences when
  6564.               mixed with chains to new batch files.  The GOSUB, and any
  6565.               block that contains it, remains active after the second batch
  6566.               file ends.  Here is another example that will NOT work:
  6567.  
  6568.                    BAT1:
  6569.  
  6570.                    rem  do something here
  6571.                    gosub sub1
  6572.                    quit
  6573.                    :sub1
  6574.                    rem  do something else here
  6575.                    if [some condition] BAT2
  6576.                    return
  6577.  
  6578.  
  6579.                    BAT2:
  6580.  
  6581.                    rem  do some more work
  6582.                    BAT1
  6583.  
  6584.               If the condition near the end of BAT1 is true, then BAT2 is
  6585.               launched.  But BAT2 ends by restarting BAT1.  The original
  6586.               BAT1's subroutine is still pending.  Since 4DOS has no way to
  6587.               detect this infinite loop, it will eventually suffer a stack
  6588.               overflow and hang the system.  If you do want to chain from
  6589.               one batch file to another, set an environment variable inside
  6590.               the GOSUB block and then use that variable outside the block
  6591.               to see whether you should CALL another batch file.
  6592.  
  6593.  
  6594.  
  6595.  
  6596.  
  6597.           ___________________________________________________________________
  6598.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  108
  6599.  
  6600.                                                CHAPTER 6 / OPTIONS AND TUNING
  6601.           ___________________________________________________________________
  6602.  
  6603.  
  6604.  
  6605.           ## CHAPTER 6 / OPTIONS AND TUNING
  6606.  
  6607.  
  6608.           Normally, the 4DOS install program will properly set up your system
  6609.           to run 4DOS.  It must, however, make certain assumptions about your
  6610.           computer and the way that you will use 4DOS.  This chapter explains
  6611.           how you can tune 4DOS to make it as efficient and as useful as
  6612.           possible in your computing environment.
  6613.  
  6614.           Nearly everything in this chapter is for advanced users and those
  6615.           with unusual needs.  If 4DOS works the way you want it to after the
  6616.           automatic installation, you can skip this chapter.  You may,
  6617.           however, want to skim this material to see what options are
  6618.           available.
  6619.  
  6620.  
  6621.           Configuration Files
  6622.  
  6623.               4DOS uses five configuration files.  Two are for general DOS
  6624.               configuration;  the other three are unique to 4DOS.  The
  6625.               general DOS files are CONFIG.SYS and AUTOEXEC.BAT.  The
  6626.               specialized 4DOS files are called 4START.BTM, 4EXIT.BTM, and
  6627.               4DOS.INI.  These five files are discussed in order in this
  6628.               section.
  6629.  
  6630.             ! Anytime you change a configuration file, a typographical
  6631.               mistake or other error could make your system lock up or run
  6632.               erratically.  Before you make any changes to any of these
  6633.               files, we strongly urge you to take the same precautions.
  6634.  
  6635.               First, create a boot-up floppy diskette (you can use the
  6636.               FORMAT /S command) and make sure that you can use it to boot
  6637.               your computer.  Second, make a backup copy of all five
  6638.               configuration files.  You might want to create copies that
  6639.               have the same base name plus an extension of .BAK.  Copy the
  6640.               .BAK files to your boot-up floppy for safe keeping.  You also
  6641.               might want to make a copy of your computer's SETUP information
  6642.               (on 80286, 386, and 486 computers) and save it on this floppy.
  6643.               If the battery that keeps that data in your computer fails,
  6644.               this file will be invaluable after you install a new battery.
  6645.               A short text file should be sufficient.
  6646.  
  6647.               With these two precautions, if something goes wrong, you will
  6648.               be able to boot with your floppy diskette and copy the files
  6649.               back to their original names.  You'll only have to spend a few
  6650.               minutes recovering your system.  You probably will want to
  6651.               follow the same precautions each time you install a new
  6652.  
  6653.  
  6654.           ___________________________________________________________________
  6655.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  109
  6656.  
  6657.                                                CHAPTER 6 / OPTIONS AND TUNING
  6658.           ___________________________________________________________________
  6659.  
  6660.  
  6661.               application program that changes your DOS or 4DOS
  6662.               configuration files.
  6663.  
  6664.  
  6665.           Setting up CONFIG.SYS
  6666.  
  6667.               The CONFIG.SYS file contains instructions for DOS to execute
  6668.               before it loads a command processor.  Only one line in the
  6669.               CONFIG.SYS file affects 4DOS.  It tells DOS to use 4DOS as the
  6670.               command processor instead of COMMAND.COM.  The format of this
  6671.               line is:
  6672.  
  6673.                    SHELL=d:\path\4DOS.COM [d:\path] [@d:\path\inifile]
  6674.                          [/D] [/E:nnnn] [/F] [/P[:file]] [//iniline]...
  6675.                          [[/K:]command]
  6676.  
  6677.               "SHELL=" identifies this line as defining the command
  6678.               processor that DOS will load after it finishes executing the
  6679.               commands in CONFIG.SYS.  It is required.
  6680.  
  6681.               If 4DOS is not in the root directory of the boot drive,
  6682.               replace the first "d:\path\" (immediately after "SHELL=") with
  6683.               the 4DOS drive and directory (if you are using DOS 2.x, 4DOS
  6684.               must be in the root directory of the boot drive).  The drive
  6685.               and path must be correct or your system won't boot (and you'll
  6686.               be very happy that you made the boot-up floppy we suggested).
  6687.  
  6688.               The remainder of the items on this line are optional.  If they
  6689.               are used, you should not include the square brackets.  Any
  6690.               items you do use should appear in the order shown below.  If
  6691.               you use a different order the options will work, but may not
  6692.               behave as you'd expect -- for example, a value on the command
  6693.               line may not take precedence over one in the 4DOS.INI file
  6694.               when you want it to.  The proper order is:
  6695.  
  6696.                    *  d:\path
  6697.  
  6698.                    *  @d:\path\inifile
  6699.  
  6700.                    *  any switches beginning with a "/" (in any order)
  6701.  
  6702.                    *  any //iniline directives (in any order)
  6703.  
  6704.                    *  [/K:]command
  6705.  
  6706.               In the descriptions below, "d:" means a drive letter and
  6707.               "\path" means a subdirectory name.
  6708.  
  6709.  
  6710.  
  6711.           ___________________________________________________________________
  6712.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  110
  6713.  
  6714.                                                CHAPTER 6 / OPTIONS AND TUNING
  6715.           ___________________________________________________________________
  6716.  
  6717.  
  6718.               d:\path      This is the "d:\path" option shown in square
  6719.                            brackets above (not the "d:\path" immediately
  6720.                            after "SHELL=").  It sets the drive and directory
  6721.                            where 4DOS is stored.  4DOS uses this path to set
  6722.                            the COMSPEC environment variable.  When running
  6723.                            under MS-DOS or PC-DOS 3.0 or above, 4DOS will
  6724.                            normally find itself automatically and this
  6725.                            option will not be needed.  When running under
  6726.                            DR-DOS this option is required unless 4DOS.COM is
  6727.                            in the root directory of the boot drive.  When
  6728.                            4DOS is running as the primary command processor,
  6729.                            you can tell if COMSPEC has been set correctly by
  6730.                            typing the following line at the 4DOS prompt:
  6731.  
  6732.                                    echo %comspec
  6733.  
  6734.                            If 4DOS has properly located itself, the location
  6735.                            of 4DOS.COM will be correctly displayed.  If the
  6736.                            COMSPEC is incorrect, you can set it yourself in
  6737.                            AUTOEXEC.BAT, or add this "d:\path" option on the
  6738.                            SHELL= line.
  6739.  
  6740.               @d:\path\inifile
  6741.                            This option sets the path and name of the
  6742.                            4DOS.INI file, which is discussed below.  If the
  6743.                            INI file is in the same directory as 4DOS.COM, or
  6744.                            is in the root directory of the boot drive, and
  6745.                            is named 4DOS.INI, or if you aren't using an INI
  6746.                            file at all, then this option is not needed.
  6747.                            Otherwise, it must be included.
  6748.  
  6749.               /D           Disables AUTOEXEC.  A /D overrides AutoExecPath
  6750.                            (see page 125) and any filename listed after a /P
  6751.                            (see below).  This switch is intended for
  6752.                            internal use by MS-DOS 6.0 when you use the F8
  6753.                            key at boot time, and answer "No" to the "Run
  6754.                            AUTOEXEC" question.
  6755.  
  6756.               /E:nnnn      This option sets the size of the environment, in
  6757.                            bytes.  If you don't use this option, 4DOS will
  6758.                            allocate 512 bytes for the environment.  You can
  6759.                            use any value from 256 to 32000 as the
  6760.                            environment size.  For example, to set an
  6761.                            environment of 1,000 bytes, you would enter the
  6762.                            option this way:
  6763.  
  6764.                                    /E:1000
  6765.  
  6766.  
  6767.  
  6768.           ___________________________________________________________________
  6769.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  111
  6770.  
  6771.                                                CHAPTER 6 / OPTIONS AND TUNING
  6772.           ___________________________________________________________________
  6773.  
  6774.  
  6775.                            You can also set the environment size with the
  6776.                            Environment directive in the 4DOS.INI file (see
  6777.                            below).
  6778.  
  6779.               /F           This option tells 4DOS to automatically provide a
  6780.                            Fail response to all critical errors, without
  6781.                            prompting or waiting for a user response.  It is
  6782.                            rarely used except on systems that must run
  6783.                            unattended, like bulletin boards.  We do not
  6784.                            recommend use of this option on a normal system,
  6785.                            because you will not have a chance to react to a
  6786.                            critical error and correct the problem that
  6787.                            caused it.  For more information on critical
  6788.                            errors see page 151.  /F only affects critical
  6789.                            errors detected by 4DOS, and will not affect
  6790.                            critical error handling for many application
  6791.                            programs which perform this function themselves.
  6792.  
  6793.               /P[:file]    This option tells 4DOS to load permanently and to
  6794.                            run AUTOEXEC.BAT.  When 4DOS is loaded from the
  6795.                            SHELL= command in CONFIG.SYS, it will detect that
  6796.                            it is the primary shell and set the /P option
  6797.                            automatically.  Under very rare circumstances you
  6798.                            may want to load 4DOS permanently and have it run
  6799.                            AUTOEXEC even though you are not loading it from
  6800.                            CONFIG.SYS; in such cases you must set /P
  6801.                            yourself.  4DOS will not run AUTOEXEC.BAT without
  6802.                            a /P.  Do not use this option in secondary
  6803.                            shells, or you will be unable to return to the
  6804.                            primary shell.
  6805.  
  6806.                            The optional ":file" after /P sets the path and
  6807.                            file name for the AUTOEXEC file.  It is
  6808.                            equivalent to using the AutoExecPath directive in
  6809.                            4DOS.INI (see page 125), and is included for
  6810.                            compatibility with OS/2 2.1.  The ":file" is
  6811.                            added automatically by OS/2 2.1 whenever the
  6812.                            DOS_AUTOEXEC setting is used for a DOS session.
  6813.                            You do not need to add it yourself.  If ":file"
  6814.                            includes only a path, 4DOS will look for
  6815.                            AUTOEXEC.BAT in the named directory.  If it
  6816.                            includes a file name as well, 4DOS will look for
  6817.                            that file instead of AUTOEXEC.BAT.
  6818.  
  6819.               //iniline    This option tells 4DOS to treat the text
  6820.                            appearing between the // and the next space or
  6821.                            tab as a 4DOS.INI directive (see page 119 for
  6822.                            information on 4DOS.INI directives).  The
  6823.  
  6824.  
  6825.           ___________________________________________________________________
  6826.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  112
  6827.  
  6828.                                                CHAPTER 6 / OPTIONS AND TUNING
  6829.           ___________________________________________________________________
  6830.  
  6831.  
  6832.                            directive should be in the same format as a line
  6833.                            in 4DOS.INI, but may not contain spaces, tabs, or
  6834.                            comments.  Directives on the SHELL= line override
  6835.                            any corresponding directive in 4DOS.INI.  This is
  6836.                            a convenient way to place one or two simple
  6837.                            directives on the SHELL= line without having to
  6838.                            modify or create a 4DOS.INI file, but is
  6839.                            primarily intended for use in secondary shells
  6840.                            (see below).
  6841.  
  6842.               [/K:]command
  6843.                            Tells 4DOS to run the command included on the
  6844.                            SHELL= line.  The command will be run after
  6845.                            4START and AUTOEXEC.BAT but before displaying the
  6846.                            prompt.  It can be any valid alias, internal or
  6847.                            external command, or batch file, and can include
  6848.                            multiple commands (but see the Caution below).
  6849.  
  6850.                            All other startup options (such as /F and /P)
  6851.                            must be placed before the command, because 4DOS
  6852.                            will treat characters after the command as part
  6853.                            of the command and not as additional startup
  6854.                            options.
  6855.  
  6856.                            For compatibility reasons, if the command is
  6857.                            preceded by /K in a primary shell under MS-DOS
  6858.                            6.0 and above, 4DOS will execute the command
  6859.                            instead of AUTOEXEC.BAT.  However in other
  6860.                            environments (DOS 5.0, OS/2 DOS sessions, etc.),
  6861.                            a preceding /K tells 4DOS to execute the command
  6862.                            after AUTOEXEC.BAT, and is equivalent to
  6863.                            including the command alone, without the /K.
  6864.  
  6865.  
  6866.               Caution
  6867.  
  6868.             ! There is a bug in all versions of MS-DOS and PC-DOS from 2.0
  6869.               through 4.01.  In all these versions, the SHELL= line in the
  6870.               CONFIG.SYS file may not contain more than 31 characters
  6871.               following the name of the shell program (i.e., beginning with
  6872.               the space after the "M" in "4DOS.COM").  If the line is too
  6873.               long, the options will not be passed properly to 4DOS and a
  6874.               variety of errors can occur.  You can set all necessary 4DOS
  6875.               options without exceeding this limit, especially if you put
  6876.               4DOS.COM and 4DOS.INI in the root directory of your boot
  6877.               drive.  This limit is not present in MS-DOS 5.0 and above or
  6878.               in DR-DOS.
  6879.  
  6880.  
  6881.  
  6882.           ___________________________________________________________________
  6883.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  113
  6884.  
  6885.                                                CHAPTER 6 / OPTIONS AND TUNING
  6886.           ___________________________________________________________________
  6887.  
  6888.  
  6889.               4DOS and DOS 2
  6890.  
  6891.               We recommend using DOS 3.1 or above, but 4DOS can be used with
  6892.               DOS 2.  The only special consideration is that 4DOS must be
  6893.               loaded differently under DOS 2.x, because certain DOS 2
  6894.               functions require that COMMAND.COM be loaded as the primary
  6895.               command processor.  Therefore, you must load COMMAND.COM first
  6896.               and then 4DOS.  Assuming that all files are in the root
  6897.               directory of your boot drive, the SHELL= line in DOS 2.x
  6898.               should look like this:
  6899.  
  6900.                    shell=command.com /c 4DOS [options]
  6901.  
  6902.               Note that due to the "/c 4DOS" on the SHELL line, fewer
  6903.               options can be used before running into the 31-character
  6904.               limit.  You must, however, use the /P option, or AUTOEXEC.BAT
  6905.               will not run.  4DOS will not automatically detect that it is
  6906.               the primary shell and set /P for you when run under DOS 2.
  6907.  
  6908.  
  6909.               Startup Options for Secondary Shells
  6910.  
  6911.               In most cases, secondary shells do not use or require any of
  6912.               the startup options defined for the primary shell in
  6913.               CONFIG.SYS.  Usually, you can only set explicit options for a
  6914.               4DOS secondary shell when you define a 4DOS window in a
  6915.               multitasking system such as Back & Forth, DESQview, Windows,
  6916.               or the MS-DOS shell (DOSSHELL); or in rare cases when you run
  6917.               a secondary copy of 4DOS directly from the command line.  If
  6918.               you do need to set options for secondary shells, you can use
  6919.               any of the following, in the order shown:
  6920.  
  6921.               @d:\path\inifile
  6922.                            Set INI file name, as in CONFIG.SYS (see above).
  6923.                            This option is not necessary if you want 4DOS to
  6924.                            use the same INI file that you used for the
  6925.                            primary shell, as values from that file --
  6926.                            including those in its [Secondary] section --
  6927.                            will be passed automatically to secondary shells.
  6928.  
  6929.               /E:nnnn      Set the environment size, as in CONFIG.SYS (see
  6930.                            above).
  6931.  
  6932.               /F           Force an automatic "Fail" on critical error, as
  6933.                            in CONFIG.SYS (see above).
  6934.  
  6935.               //iniline    This option tells 4DOS to treat the text
  6936.                            appearing between the // and the next space or
  6937.  
  6938.  
  6939.           ___________________________________________________________________
  6940.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  114
  6941.  
  6942.                                                CHAPTER 6 / OPTIONS AND TUNING
  6943.           ___________________________________________________________________
  6944.  
  6945.  
  6946.                            tab as a 4DOS.INI directive (see page 119 for
  6947.                            more information on 4DOS.INI directives).  The
  6948.                            directive should be in the same format as a line
  6949.                            in 4DOS.INI, but may not contain spaces, tabs, or
  6950.                            comments.  Directives on the SHELL= line override
  6951.                            any corresponding directive in 4DOS.INI.  This
  6952.                            allows you to use 4DOS.INI directives directly on
  6953.                            the command line when starting 4DOS in a window
  6954.                            of a multitasking system, rather than having to
  6955.                            create separate copies of 4DOS.INI to accommodate
  6956.                            small configuration changes in different windows.
  6957.  
  6958.               [/C | /K] command
  6959.                            This option tells 4DOS to run the command
  6960.                            included on the line.  The command will be run
  6961.                            after 4START but before any command prompt is
  6962.                            displayed.  It can be any valid alias, internal
  6963.                            or external command, or batch file, and can
  6964.                            include multiple commands.  Use this option if
  6965.                            you want 4DOS to run a batch file or execute a
  6966.                            command when it starts, for example to run a
  6967.                            specific batch file when 4DOS is started in a
  6968.                            window of a multitasking system.
  6969.  
  6970.                            When the command is preceded by a /C, 4DOS will
  6971.                            execute the command and then exit and return to
  6972.                            the parent program.  /C is used by some
  6973.                            applications to start the command processor, run
  6974.                            one command, and the return to the application.
  6975.                            This option can be used when 4DOS is run as a
  6976.                            secondary shell, but never in the SHELL statement
  6977.                            in the CONFIG.SYS file.
  6978.  
  6979.                            The /K switch has no effect; using it is the same
  6980.                            as placing the command (without a /C or /K) at
  6981.                            the end of the startup command line.  It is
  6982.                            included only for compatibility with COMMAND.COM
  6983.                            in OS/2 version 2.
  6984.  
  6985.  
  6986.  
  6987.  
  6988.           Using AUTOEXEC.BAT
  6989.  
  6990.               If 4DOS is the primary command processor, it is up and running
  6991.               before AUTOEXEC.BAT is executed.  You generally won't need to
  6992.               make any changes to AUTOEXEC.BAT to make it run properly under
  6993.  
  6994.  
  6995.  
  6996.           ___________________________________________________________________
  6997.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  115
  6998.  
  6999.                                                CHAPTER 6 / OPTIONS AND TUNING
  7000.           ___________________________________________________________________
  7001.  
  7002.  
  7003.               4DOS, although once you get used to some of 4DOS's batch file
  7004.               enhancements, you may want to use them to streamline AUTOEXEC.
  7005.  
  7006.               If you want to use the 4DOS KEYSTACK command, you will
  7007.               normally load the program KSTACK.COM from your AUTOEXEC.BAT
  7008.               file.  To do so, include the following line in your file.  Its
  7009.               location in the file is unimportant as long as you place it
  7010.               before any KEYSTACK commands:
  7011.  
  7012.                    d:\path\kstack.com
  7013.  
  7014.               Replace the "d:\path" with the path to the KSTACK.COM program,
  7015.               which will normally be stored in your 4DOS directory.
  7016.  
  7017.               You may want to use AUTOEXEC.BAT to configure 4DOS the way you
  7018.               want it by setting some of the environment variables that 4DOS
  7019.               uses.  You may also want to include a SETDOS command (see page
  7020.               305) to set configuration variables (most of these variables
  7021.               can also be set in the 4DOS.INI file discussed below).  All of
  7022.               these settings are optional.
  7023.  
  7024.               4DOS uses seven environment variables.  Five of the seven (all
  7025.               except PATH and PROMPT) are created with the SET command (see
  7026.               page 302) using this format:
  7027.  
  7028.                    set name=value
  7029.  
  7030.               The seven variables and their uses are explained below:
  7031.  
  7032.                    COMSPEC:  The COMSPEC variable is the path and filename
  7033.                    that programs use to launch a secondary shell.  Normally,
  7034.                    this will be set automatically by 4DOS as it installs
  7035.                    itself.  However, in rare circumstances you may wish to
  7036.                    load 4DOS.COM for secondary shells from a directory other
  7037.                    than the one it's in when you boot (for example, from a
  7038.                    RAM disk).  In these cases, you will need to reset the
  7039.                    COMSPEC variable.  For example, if you want to load
  7040.                    secondary copies of 4DOS.COM from the root directory of
  7041.                    drive D, you would use this command:
  7042.  
  7043.                         set comspec=D:\4DOS.COM
  7044.  
  7045.                    PATH:  The PATH variable lists the directories that 4DOS
  7046.                    should search for executable files that aren't in the
  7047.                    current directory (executable files include .COM, .EXE,
  7048.                    .BTM, and .BAT files and files with executable
  7049.                    extensions).  The PATH variable is normally set with the
  7050.                    PATH command.  See PATH on page 276 for more details.
  7051.  
  7052.  
  7053.           ___________________________________________________________________
  7054.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  116
  7055.  
  7056.                                                CHAPTER 6 / OPTIONS AND TUNING
  7057.           ___________________________________________________________________
  7058.  
  7059.  
  7060.                    PROMPT:  The prompt variable defines the 4DOS command
  7061.                    prompt.  It is normally set with the PROMPT command.  See
  7062.                    PROMPT on page 280 for details about the options
  7063.                    available.
  7064.  
  7065.                    TEMP4DOS:  This variable contains the drive and directory
  7066.                    that 4DOS will use to store temporary pipe files (see
  7067.                    page 66).  If you have a RAM disk, piping will be faster
  7068.                    if you direct 4DOS to use it for the pipe files.  This
  7069.                    variable should hold a single path.  The path can be
  7070.                    terminated with a backslash [\] if you choose, but this
  7071.                    is not required.  For example, to direct pipe temporary
  7072.                    files to the TEMP directory on drive D:
  7073.  
  7074.                         set temp4dos=d:\temp
  7075.  
  7076.                    TEMP:  If TEMP4DOS does not exist, 4DOS looks for this
  7077.                    variable to find the path for temporary pipe files (if
  7078.                    neither exists, 4DOS uses the root directory of the drive
  7079.                    from which it was started).  TEMP is also used by some
  7080.                    other programs to set a path for their temporary files.
  7081.                    The format of TEMP is the same as TEMP4DOS.
  7082.  
  7083.                    COLORDIR:  This variable sets the colors that 4DOS will
  7084.                    use for directories displayed by the DIR and SELECT
  7085.                    commands.  See those commands (page 210 and 296) for
  7086.                    details about COLORDIR.
  7087.  
  7088.                    CDPATH:  This variable defines default directories to be
  7089.                    used by the CD and CDD commands, and by automatic
  7090.                    directory changes.  If CD, CDD, or an automatic directory
  7091.                    entry cannot find the path you specify on the command
  7092.                    line, 4DOS will try appending the command line path to
  7093.                    each path in this variable.  For example, you may have a
  7094.                    C:\LETTERS directory that has subdirectories named JAN,
  7095.                    FEB, MARCH, etc.  You can put C:\LETTERS into CDPATH and
  7096.                    get to the FEB directory from anywhere on your system by
  7097.                    typing CDD FEB or FEB\.
  7098.  
  7099.                    The format of the CDPATH variable is the same as the PATH
  7100.                    variable:  a list of directories separated by semicolons.
  7101.                    For example:
  7102.  
  7103.                         set cdpath=c:\letters;c:\data;c:\memos
  7104.  
  7105.  
  7106.  
  7107.  
  7108.  
  7109.  
  7110.           ___________________________________________________________________
  7111.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  117
  7112.  
  7113.                                                CHAPTER 6 / OPTIONS AND TUNING
  7114.           ___________________________________________________________________
  7115.  
  7116.  
  7117.           Using 4START and 4EXIT
  7118.  
  7119.               4DOS runs two special batch files automatically, 4START.BTM
  7120.               and 4EXIT.BTM (you can make them .BAT files, if you prefer).
  7121.               4START is executed whenever 4DOS is started as a primary or
  7122.               secondary shell.  In the primary shell, it is executed before
  7123.               AUTOEXEC.BAT.  If 4DOS is started as a secondary shell with
  7124.               the /C command option, 4START is executed before the command.
  7125.  
  7126.               A 4START file is normally very short.  You should NOT load any
  7127.               memory-resident programs (TSRs) from 4START because they will
  7128.               be reloaded every time a secondary shell is started.
  7129.               Normally, 4START is used to vary the PROMPT setting or screen
  7130.               colors from shell to shell.  The LOG command is sometimes used
  7131.               in 4START to record that a new shell has begun.  A PAUSE
  7132.               command inserted temporarily in 4START will let you see if a
  7133.               particular program is running a secondary shell with the /C
  7134.               command option to accomplish some of its own work.  Do not
  7135.               load aliases from 4START -- 4DOS passes them along to a
  7136.               secondary shell automatically, so you only need to load them
  7137.               once, in AUTOEXEC.
  7138.  
  7139.               The 4EXIT batch file is executed every time a secondary 4DOS
  7140.               command processor ends.  A secondary shell can end because of
  7141.               an EXIT command or after completing the command specified with
  7142.               a /C command startup option.  Normally, 4EXIT is used to LOG a
  7143.               record that the shell has ended.  You might also use 4EXIT to
  7144.               view the results of the command that an application has given
  7145.               to 4DOS, or to save the history accumulated during that shell
  7146.               with the HISTORY command with output redirected to a file.
  7147.  
  7148.               4DOS looks for the 4START and 4EXIT batch files in three
  7149.               places:
  7150.  
  7151.                    *  If the 4DOS.INI file has a 4StartPath entry, 4DOS will
  7152.                       use it, and will not look elsewhere.
  7153.  
  7154.                    *  If 4StartPath is not set, 4DOS will look in the
  7155.                       directory where 4DOS.COM is stored.  For the primary
  7156.                       shell, 4DOS determines this directory automatically, or
  7157.                       you can set it yourself by placing a COMSPEC directory
  7158.                       name on the SHELL= line in CONFIG.SYS (see page 111).
  7159.                       For secondary shells, the directory is determined from
  7160.                       the COMSPEC environment variable (see page 116).
  7161.  
  7162.                    *  If the COMSPEC directory search fails, 4DOS will look
  7163.                       in the root directory of the boot drive.
  7164.  
  7165.  
  7166.  
  7167.           ___________________________________________________________________
  7168.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  118
  7169.  
  7170.                                                CHAPTER 6 / OPTIONS AND TUNING
  7171.           ___________________________________________________________________
  7172.  
  7173.  
  7174.               The easiest way to make sure that 4DOS finds the 4START and
  7175.               4EXIT batch files is to specify their location with the
  7176.               4StartPath directive in the 4DOS.INI file (see below).  If you
  7177.               don't, put 4START and 4EXIT in the root directory of the boot
  7178.               drive.  If the COMSPEC drive is not the same as the boot
  7179.               drive, then you should also put a copy of 4START and 4EXIT in
  7180.               the root directory of the COMSPEC drive.
  7181.  
  7182.  
  7183.           Using the 4DOS.INI File
  7184.  
  7185.               4DOS uses a file of initialization information called the
  7186.               4DOS.INI file.  You can create, add to, and edit this file
  7187.               with any ASCII text editor to set 4DOS options and alter the
  7188.               way that 4DOS works.  The 4DOS installation program will
  7189.               create a 4DOS.INI file for you if one does not already exist
  7190.               on your system.  Most of this section explains the options
  7191.               available through 4DOS.INI.  You only need to include entries
  7192.               in 4DOS.INI for any settings that you want to change from
  7193.               their default values.  If you are happy with all of 4DOS's
  7194.               default values, you don't need a 4DOS.INI file at all.
  7195.  
  7196.               Some settings in 4DOS.INI are initialized when you install
  7197.               4DOS, so you may have a 4DOS.INI file even if you didn't
  7198.               create one yourself.  You should not delete this file unless
  7199.               you've checked carefully to be sure that you don't need any of
  7200.               the settings the initialization program put there.
  7201.  
  7202.               When 4DOS is loaded as the primary shell, it searches for the
  7203.               4DOS.INI file in three places:
  7204.  
  7205.                    *  If there is an "@d:\path\inifile" option on the SHELL=
  7206.                       line in CONFIG.SYS (see page 111), 4DOS will use the
  7207.                       path and file name specified there, and will not look
  7208.                       elsewhere.
  7209.  
  7210.                    *  If there is no INI file path or name on the SHELL=
  7211.                       line, 4DOS will look in the same directory where
  7212.                       4DOS.COM is stored (this is the "normal" location for
  7213.                       4DOS.INI).  4DOS determines this directory
  7214.                       automatically, or you can set it yourself by placing a
  7215.                       COMSPEC directory name on the SHELL= line in CONFIG.SYS
  7216.                       (see page 111).
  7217.  
  7218.                    *  If the COMSPEC directory search fails, 4DOS will look
  7219.                       in the root directory of the boot drive.
  7220.  
  7221.  
  7222.  
  7223.  
  7224.           ___________________________________________________________________
  7225.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  119
  7226.  
  7227.                                                CHAPTER 6 / OPTIONS AND TUNING
  7228.           ___________________________________________________________________
  7229.  
  7230.  
  7231.               When 4DOS is loaded as a secondary shell, it does not search
  7232.               for the 4DOS.INI file.  Instead, it reprocesses the file used
  7233.               for the primary shell (if necessary), then processes any
  7234.               "@d:\path\inifile" option on the secondary shell command line
  7235.               (see page 114).  You can override this behavior with the
  7236.               NextINIFile directive (see page 140).
  7237.  
  7238.               Most lines in the 4DOS.INI file consist of a one-word
  7239.               directive, an equal sign [=], and a value.  For example, in
  7240.               the following line, the word "Environment" is the directive
  7241.               and "2048" is the value:
  7242.  
  7243.                    Environment = 2048
  7244.  
  7245.               Any spaces before or after the equal sign are ignored.  The
  7246.               directive name may be abbreviated to the minimum length needed
  7247.               to make it unique; 4DOS will display an error if the name you
  7248.               use is unknown or ambiguous.  We recommend that you use full-
  7249.               length directive names, since future versions of 4DOS may add
  7250.               directives that would make your abbreviations ambiguous and
  7251.               cause an error.
  7252.  
  7253.               If you have a long string to enter in 4DOS.INI (for example,
  7254.               for the ColorDir directive), you must enter it all on one
  7255.               line.  Strings cannot be "continued" to a second line.  Each
  7256.               line may be up to 511 characters long.
  7257.  
  7258.               The format of the value part of a directive line depends on
  7259.               the individual directive.  It may be a numeric value, a single
  7260.               character, a choice (like "Yes" or "No"), a color setting, a
  7261.               key name, a path, a filename, or a text string.  The value
  7262.               begins with the first non-blank character after the equal sign
  7263.               and ends at the end of the line or the beginning of a comment.
  7264.  
  7265.               Blank lines are ignored in the 4DOS.INI file and can be used
  7266.               to separate groups of directives.  You can place comments in
  7267.               the file by beginning a line with a semicolon [;].  You can
  7268.               also place comments at the end of any line except one
  7269.               containing a text string value.  To do so, enter at least one
  7270.               space or tab after the value, a semicolon, and your comment,
  7271.               like this:
  7272.  
  7273.                    Environment = 2048        ;set standard environment size
  7274.  
  7275.               If you try to place a comment at the end of a string value,
  7276.               the comment will become part of the string and will probably
  7277.               cause an error.
  7278.  
  7279.  
  7280.  
  7281.           ___________________________________________________________________
  7282.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  120
  7283.  
  7284.                                                CHAPTER 6 / OPTIONS AND TUNING
  7285.           ___________________________________________________________________
  7286.  
  7287.  
  7288.               When 4DOS detects an error while processing the 4DOS.INI file,
  7289.               it displays an error message, ignores the line that caused the
  7290.               error, and prompts you to press a key to continue processing
  7291.               the file.  This allows you to note any errors before the
  7292.               startup process continues.  The directive in error will retain
  7293.               its previous or default value.  Only the most catastrophic
  7294.               errors (like a disk read failure) will cause 4DOS to ignore
  7295.               all or a large part of the 4DOS.INI file.  If you don't want
  7296.               4DOS to pause after each error, use a "PauseOnError = No"
  7297.               directive at the beginning of the file.
  7298.  
  7299.               The 4DOS.INI file has two sections, which are identified by a
  7300.               name in square brackets on a line by itself.  The section
  7301.               names are
  7302.  
  7303.                    [Primary]:  Directives in this section will be used when
  7304.                    4DOS is running as the primary shell.  The same values
  7305.                    will be passed automatically to all secondary shells,
  7306.                    unless overridden by a directive with the same name in
  7307.                    the [Secondary] section.
  7308.  
  7309.                    [Secondary]:  Directives in this section are used in
  7310.                    secondary shells only, and override any corresponding
  7311.                    primary shell settings.  For example, if your 4DOS.INI
  7312.                    file contains the lines:
  7313.  
  7314.                         ScreenRows = 25
  7315.                         [Secondary]
  7316.                         ScreenRows = 50
  7317.  
  7318.                    then 4DOS will assume that you have 25 rows on the screen
  7319.                    in the primary shell and 50 lines in all secondary
  7320.                    shells.
  7321.  
  7322.               Lines that precede a section name are used in both primary and
  7323.               secondary shells.
  7324.  
  7325.               The SETDOS command can override several of the 4DOS.INI file
  7326.               directives.  For example, the number of rows on the screen can
  7327.               be adjusted with SETDOS /R.  The correspondence between SETDOS
  7328.               options and INI file directives is noted under each directive
  7329.               below, and under each option of the SETDOS command.
  7330.  
  7331.               Secondary shells automatically inherit the configuration
  7332.               settings currently in effect in the previous shell.  If values
  7333.               have been changed by SETDOS since 4DOS started, the new values
  7334.               will be passed to the secondary shell.  If the previous
  7335.               shell's INI file had a [Secondary] section, it will then be
  7336.  
  7337.  
  7338.           ___________________________________________________________________
  7339.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  121
  7340.  
  7341.                                                CHAPTER 6 / OPTIONS AND TUNING
  7342.           ___________________________________________________________________
  7343.  
  7344.  
  7345.               read and processed.  If not, the previous shell's settings
  7346.               will remain in effect.  For example, if you set BatchEcho to
  7347.               Yes in 4DOS.INI, do not include a [Secondary] section, and use
  7348.               SETDOS /V0 to turn off batch file echoing in the primary
  7349.               shell, then secondary shells will inherit the SETDOS setting,
  7350.               i.e. batch files will default to no echo.
  7351.  
  7352.               If you want to force secondary shells to start with the same
  7353.               value as the primary shell for a particular directive,
  7354.               regardless of any changes made with SETDOS, repeat the
  7355.               directive in the [Secondary] section of 4DOS.INI.  You can
  7356.               also place the directive outside any section of 4DOS.INI, then
  7357.               include an empty [Secondary] section.  The inclusion of a
  7358.               [Secondary] section will force 4DOS to re-read 4DOS.INI, and
  7359.               the directives outside any section will be reprocessed as they
  7360.               apply to both primary and secondary shells.  Because 4DOS.INI
  7361.               is processed after values from the previous shell are
  7362.               inherited, the value in 4DOS.INI will override the inherited
  7363.               value.  Using the BatchEcho example above, either of the
  7364.               following sets of 4DOS.INI directives would work to ensure
  7365.               that BatchEcho is set to Yes in secondary shells:
  7366.  
  7367.                     Same directive                Empty
  7368.                     in both sections              [Secondary]
  7369.                     ----------------              -----------
  7370.                     [Primary]                     BatchEcho = Yes
  7371.                     BatchEcho = Yes                 ... <other
  7372.                      ... <other directives>         ...  directives>
  7373.                     [Secondary]                   [Secondary]
  7374.                     BatchEcho = Yes               <End of File>
  7375.                      ... <other directives>
  7376.  
  7377.               If you start a secondary shell from a task switching program
  7378.               like Windows, DESQview, or Back & Forth, you can specify an
  7379.               alternate location and name for 4DOS.INI by passing the
  7380.               "@d:\path\inifile" option to 4DOS as a command-line parameter
  7381.               (see page 111).  In this case, the configuration settings in
  7382.               the alternate 4DOS.INI file will supersede any settings
  7383.               inherited from the previous shell.  Any values which are not
  7384.               explicitly set in the alternate file will retain the value
  7385.               they had in the previous shell.  Any [Primary] section in the
  7386.               alternate file will be ignored because it is being run from a
  7387.               secondary shell.
  7388.  
  7389.               The first section below lists the different types of
  7390.               directives.  Subsequent sections list all the individual
  7391.               directives, divided by function and then alphabetically by
  7392.  
  7393.  
  7394.  
  7395.           ___________________________________________________________________
  7396.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  122
  7397.  
  7398.                                                CHAPTER 6 / OPTIONS AND TUNING
  7399.           ___________________________________________________________________
  7400.  
  7401.  
  7402.               directive name.  At the end we have included a few examples of
  7403.               how to use 4DOS.INI directives (see page 141).
  7404.  
  7405.  
  7406.               Types of Directives
  7407.  
  7408.               There are 8 types of directives in 4DOS.INI.  When you look at
  7409.               the descriptions below, you can tell the directive type by the
  7410.               way in which the allowable values are shown.
  7411.  
  7412.                    *  Name = nnnn (1234):  This directive takes a numeric
  7413.                       value which replaces the "nnnn."  The default value is
  7414.                       shown in parentheses.
  7415.  
  7416.                    *  Name = c (X):  This directive accepts a single
  7417.                       character as its value.  The default character is shown
  7418.                       in parentheses.  You must type in the actual character,
  7419.                       you can not use a key name.
  7420.  
  7421.                    *  Name = CHOICE1 | Choice2 | ... :  This directive takes
  7422.                       a choice value.  The possible choices are listed,
  7423.                       separated by vertical bars.  The default value is shown
  7424.                       in all upper case letters in the directive description,
  7425.                       but in your file any of the choices can be entered in
  7426.                       upper case or lower case.  The choices can be
  7427.                       abbreviated as long as the abbreviation is unique and
  7428.                       can not cause ambiguity.  For example, if the choices
  7429.                       were shown as "YES | No" then "YES" is the default.
  7430.                       You could enter "Y", "N", "y", or "n"  for the value.
  7431.                       But if the choices are shown as "YES | No | Never" then
  7432.                       you could not use "N" as an abbreviation because it
  7433.                       would be ambiguous.
  7434.  
  7435.                    *  Name = color:  This directive takes a color
  7436.                       specification in the form:
  7437.  
  7438.                         [BRIght] [BLInk] fg ON [BRIght] bg [BORder bc]
  7439.  
  7440.                       Where:
  7441.  
  7442.                          fg is the foreground color.
  7443.                          bg is the background color.
  7444.                          bc is the border color.
  7445.  
  7446.                       The allowable color names are:
  7447.  
  7448.                         Black         Blue          Green         Red
  7449.                         Magenta       Cyan          Yellow        White
  7450.  
  7451.  
  7452.           ___________________________________________________________________
  7453.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  123
  7454.  
  7455.                                                CHAPTER 6 / OPTIONS AND TUNING
  7456.           ___________________________________________________________________
  7457.  
  7458.  
  7459.                       The color names and the keywords BRIGHT, BLINK, and
  7460.                       BORDER can be shortened to three letters.  Bright
  7461.                       backgrounds will not work unless BrightBG is set to Yes
  7462.                       (see page 129).
  7463.  
  7464.                    *  Name = Key:  This directive takes a key specification
  7465.                       in the form:
  7466.  
  7467.                         [Prefix-]Keyname
  7468.  
  7469.                       The key prefix can be left out, or it can be any one of
  7470.                       the following:
  7471.  
  7472.                         Alt        followed by A - Z, 0 - 9, F1 - F12, or
  7473.                                    Bksp
  7474.                         Ctrl       followed by A - Z, F1 - F12, Bksp, Enter,
  7475.                                    Left, Right, Home, End, PgUp, PgDn, Ins,
  7476.                                    or Del
  7477.                         Shift      followed by F1 - F12 or Tab.
  7478.  
  7479.                       The possible key names are:
  7480.  
  7481.                         A - Z         Enter         PgDn
  7482.                         0 - 9         Up            Home
  7483.                         F1 - F12      Down          End
  7484.                         Esc           Left          Ins
  7485.                         Bksp          Right         Del
  7486.                         Tab           PgUp
  7487.  
  7488.                       All key names must be spelled as shown, and can be
  7489.                       abbreviated as long as the abbreviation is unique and
  7490.                       unambiguous.  Alphabetic keys can be specified in
  7491.                       upper-case or lower-case.  You cannot specify a
  7492.                       punctuation key.
  7493.  
  7494.                       The prefix and key name must be separated by a dash.
  7495.                       For example,
  7496.  
  7497.                         AddFile = Alt-F10    ; This is okay
  7498.                         AddFile = Alt F10    ; The space will cause an error
  7499.  
  7500.                       If you prefer, you can use a numeric value instead of a
  7501.                       key name.  Use the ASCII code for an ASCII, extended
  7502.                       ASCII, or control character.  Use the scan code
  7503.                       preceded by an at-sign [@] for extended key codes like
  7504.                       F1 or the cursor keys.  In general, you will find it
  7505.                       easier to use the names described above rather than key
  7506.                       numbers.
  7507.  
  7508.  
  7509.           ___________________________________________________________________
  7510.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  124
  7511.  
  7512.                                                CHAPTER 6 / OPTIONS AND TUNING
  7513.           ___________________________________________________________________
  7514.  
  7515.  
  7516.                    *  Name = Path:  This directive takes a path
  7517.                       specification, but not a filename.  The path should
  7518.                       include both a drive and path (e.g., C:\4DOS) to avoid
  7519.                       any possible ambiguities.  A trailing backslash [\] at
  7520.                       the end of the path name is acceptable but not
  7521.                       required.  Any default path is described in the text.
  7522.  
  7523.                    *  Name = File:  This directive takes a filename.  We
  7524.                       recommend that you use a full filename including the
  7525.                       drive letter and path to avoid any possible
  7526.                       ambiguities.  Any default filename is described in the
  7527.                       text.
  7528.  
  7529.                    *  Name = Anything else:  This directive takes a string in
  7530.                       the format shown.  The text describes the default value
  7531.                       and any additional requirements for formatting the
  7532.                       string correctly.  No comments are allowed.
  7533.  
  7534.               4DOS contains a fixed-length area for storing strings entered
  7535.               in 4DOS.INI, including file names, paths, and other strings.
  7536.               This area is large and is unlikely to overflow; if it does,
  7537.               you will receive an error message.  If this occurs, reduce the
  7538.               complexity of your 4DOS.INI file or contact our technical
  7539.               support department for assistance.
  7540.  
  7541.  
  7542.               Initialization Directives
  7543.  
  7544.               The directives in this section control how 4DOS starts and
  7545.               where it looks for its files.
  7546.  
  7547.                    4StartPath = Path:  Sets the drive and directory where
  7548.                    4DOS should look for the 4START and 4EXIT batch files.
  7549.  
  7550.                    Alias = nnnn  (1024):  Sets the amount of memory in bytes
  7551.                    allocated for the alias list.  The allowable range of
  7552.                    values is 256 to 32767 bytes.
  7553.  
  7554.                    AutoExecPath = File:  Sets the path and file name for
  7555.                    AUTOEXEC.BAT if 4DOS is started as a primary shell with
  7556.                    the /P option in CONFIG.SYS (see page 112).  The default
  7557.                    is the file AUTOEXEC.BAT in the root directory of the
  7558.                    boot drive.  If you specify a complete file name with
  7559.                    path, 4DOS will search for that file.  If you specify
  7560.                    only a directory name, 4DOS will look for the file
  7561.                    AUTOEXEC.BAT in the named directory.
  7562.  
  7563.  
  7564.  
  7565.  
  7566.           ___________________________________________________________________
  7567.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  125
  7568.  
  7569.                                                CHAPTER 6 / OPTIONS AND TUNING
  7570.           ___________________________________________________________________
  7571.  
  7572.  
  7573.                    EnvFree = nnnn  (128):  Sets the minimum amount of memory
  7574.                    in bytes that will be available in the environment for
  7575.                    secondary shells.  4DOS will enlarge the environment for
  7576.                    each secondary shell, if necessary, so that there is at
  7577.                    least this much free environment space when the shell
  7578.                    starts.  The allowable range of values is 128 to 32000
  7579.                    bytes.
  7580.  
  7581.                    Environment = nnnn  (512):  Sets the amount of memory
  7582.                    allocated to the environment in bytes.  The allowable
  7583.                    range of values is 256 to 32000 bytes.
  7584.  
  7585.                    HelpOptions = [/M /Sn /X]:  Sets default options for the
  7586.                    4DOS help system.  See HELP on page 241 for a list of the
  7587.                    available options.
  7588.  
  7589.                    HelpPath = Path:  Sets the path used to find 4HELP.EXE
  7590.                    when F1 is pressed or the HELP command is used.  If this
  7591.                    directive is not used, 4DOS will search the current
  7592.                    directory and each of the directories in the PATH.
  7593.  
  7594.                    History = nnnn  (1024):  Sets the amount of memory
  7595.                    allocated to the history list in bytes.  The allowable
  7596.                    range of values is 256 to 8192 bytes.
  7597.  
  7598.                    LogName = File  (none):  Sets the log file name and/or
  7599.                    path. If only a path is given, 4DOS will use the default
  7600.                    log file name (4DOSLOG).  Using LogName does not turn
  7601.                    logging on, you must still use LOG ON to do so.
  7602.  
  7603.                    PauseOnError = YES | No:  "Yes" tells 4DOS to pause with
  7604.                    the message "Error in 4DOS.INI, press any key to continue
  7605.                    processing" after displaying any error message related to
  7606.                    a specific line in the 4DOS.INI file.  "No" continues
  7607.                    processing with no pause after an error message is
  7608.                    displayed.
  7609.  
  7610.                    Swapping = swap type [, swap type] ...:  Sets the type of
  7611.                    swapping 4DOS should use.  4DOS runs in two parts, a
  7612.                    resident portion that is always in memory and a transient
  7613.                    portion that can be stored in EMS memory, in XMS memory,
  7614.                    on a RAM disk, or on your hard disk while application
  7615.                    programs are running.  The resident portion uses about 3K
  7616.                    of memory in the primary shell and about 1.5K in
  7617.                    secondary shells.  The transient portion uses about 88K
  7618.                    of memory.  4DOS will perform most quickly if the
  7619.                    transient portion is swapped to the fastest memory or
  7620.  
  7621.  
  7622.  
  7623.           ___________________________________________________________________
  7624.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  126
  7625.  
  7626.                                                CHAPTER 6 / OPTIONS AND TUNING
  7627.           ___________________________________________________________________
  7628.  
  7629.  
  7630.                    device available.  See page 49 for explanations of XMS
  7631.                    and EMS memory.
  7632.  
  7633.                    Swapping for the primary shell normally requires about
  7634.                    96K of EMS memory, or 92K of XMS memory or disk space.
  7635.                    Secondary shells normally require 32K of EMS memory, or
  7636.                    28K of XMS memory or disk space.  If you have a large
  7637.                    environment, alias list, or history list, more memory
  7638.                    will be required in both primary and secondary shells.
  7639.                    The EMS requirements are larger because EMS memory is
  7640.                    allocated in 16K increments; 4DOS does not actually use
  7641.                    more memory when swapping to EMS.
  7642.  
  7643.                    The swap type may be:
  7644.  
  7645.                          EMS:  4DOS will swap to EMS expanded memory if it is
  7646.                          available.  You must have expanded memory and an EMS
  7647.                          memory manager (version 3.2 or later) for this
  7648.                          option.
  7649.  
  7650.                          XMS:  4DOS will swap to XMS extended memory if it is
  7651.                          available (you must have an 80286, 386, or 486
  7652.                          computer for this option, and an XMS memory
  7653.                          manager).
  7654.  
  7655.                          d:\path:  4DOS will create a swap file in the drive
  7656.                          and directory specified.  The file will be called
  7657.                          4DOSSWAP.NNN where "NNN" is the shell number (unless
  7658.                          you use the UniqueSwapName directive to generate a
  7659.                          unique swap file name; see page 141).  This swap
  7660.                          file is created as a hidden system file to avoid
  7661.                          accidental deletion and will not be visible with a
  7662.                          normal DIR command.  Swapping to a RAM disk will
  7663.                          generally be somewhat faster than swapping to a hard
  7664.                          disk.  Do not use a floppy disk for swapping because
  7665.                          its performance is likely to be unacceptably slow.
  7666.  
  7667.                          None:  No swapping.  The transient portion of 4DOS
  7668.                          will remain in memory at all times.  This option
  7669.                          will reduce memory available for application
  7670.                          programs by about 90K compared to the other swap
  7671.                          types, and should be used only when no other
  7672.                          swapping options are available.
  7673.  
  7674.                    You can specify multiple swap types and 4DOS will try
  7675.                    them in the order listed.  Swap type "None" is always
  7676.                    appended to your list of possible swap types as a "last
  7677.                    resort", even if you don't include it explicitly.  This
  7678.  
  7679.  
  7680.           ___________________________________________________________________
  7681.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  127
  7682.  
  7683.                                                CHAPTER 6 / OPTIONS AND TUNING
  7684.           ___________________________________________________________________
  7685.  
  7686.  
  7687.                    allows 4DOS to start even if the other swap types you
  7688.                    specify don't work.
  7689.  
  7690.                    For example, if your system has EMS memory and a RAM disk
  7691.                    set up as drive D, the directive:
  7692.  
  7693.                          Swapping = EMS, D:\, C:\SWAP
  7694.  
  7695.                    will tell 4DOS to try EMS memory first, then the RAM
  7696.                    disk, and finally the \SWAP directory on drive C.  If all
  7697.                    of these options fail (because there isn't enough free
  7698.                    space available), the transient portion of 4DOS will
  7699.                    remain in memory (swap type "None").
  7700.  
  7701.                    The default Swapping specification is:
  7702.  
  7703.                          Swapping = EMS, XMS, x:\, None
  7704.  
  7705.                    "x" is the boot drive (for the primary shell) or the
  7706.                    COMSPEC drive (for secondary shells).  (Disk swapping
  7707.                    will not be included as a default if the boot drive is A:
  7708.                    or B:, because floppy disk swapping is too slow to be
  7709.                    useful on most systems.)  The default is usually adequate
  7710.                    for most systems.
  7711.  
  7712.                    UMBEnvironment = Yes | NO:  "Yes" attempts to load the
  7713.                    master environment into a UMB (Upper Memory Block).  This
  7714.                    reduces 4DOS's base memory requirements but may cause
  7715.                    problems with some programs that try to access the master
  7716.                    environment directly.  This option requires a 386 or 486
  7717.                    computer and appropriate support software, or an 8086/88
  7718.                    or 80286 computer and appropriate support hardware and
  7719.                    software.  (See pages 50 and 144 for more information on
  7720.                    UMBs.)
  7721.  
  7722.                    UMBLoad = Yes | NO:  "Yes" attempts to load the resident
  7723.                    portion of 4DOS into a UMB (Upper Memory Block).  This
  7724.                    reduces the size of the resident portion in base memory
  7725.                    from about 3K bytes to 256 bytes, plus the environment
  7726.                    size (unless you have also enabled UMBEnvironment).  This
  7727.                    option requires a 386 or 486 computer and appropriate
  7728.                    support software, or an 8086/88 or 80286 computer and
  7729.                    appropriate support hardware and software.  (See pages 50
  7730.                    and 144 for more information on UMBs.)
  7731.  
  7732.  
  7733.  
  7734.  
  7735.  
  7736.  
  7737.           ___________________________________________________________________
  7738.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  128
  7739.  
  7740.                                                CHAPTER 6 / OPTIONS AND TUNING
  7741.           ___________________________________________________________________
  7742.  
  7743.  
  7744.               Configuration Directives
  7745.  
  7746.               These directives control the way that 4DOS operates.  Some can
  7747.               be changed with the SETDOS command while 4DOS is running.  Any
  7748.               corresponding SETDOS command is listed in the description of
  7749.               each directive;  information on SETDOS is on page 305.
  7750.  
  7751.                    AmPm = Yes | NO | Auto:  Yes tells 4DOS to display times
  7752.                    in 12-hour format with a trailing "a" for AM or "p" for
  7753.                    PM.  The default of No formats times in military (24-
  7754.                    hour) format.  Auto formats the time according to the
  7755.                    country code set for your system.  The time format
  7756.                    selected by AmPm applies to DIR and SELECT displays, LOG
  7757.                    files, the output of TIMER, and the DATE and TIME
  7758.                    commands.  It does not affect %_TIME, %@MAKETIME, or
  7759.                    PROMPT $t and $T.
  7760.  
  7761.                    ANSI = AUTO | Yes | No:  Tells 4DOS whether an ANSI
  7762.                    driver is installed and should be used for the CLS and
  7763.                    COLOR commands.  4DOS normally determines this itself,
  7764.                    but if you are using a non-standard ANSI driver or your
  7765.                    loading sequence is unusual, you may need to explicitly
  7766.                    inform 4DOS.  Also see SETDOS /A.
  7767.  
  7768.                    BatchEcho = YES | No:  Sets the default batch ECHO mode.
  7769.                    "Yes" enables echoing of all batch file commands unless
  7770.                    ECHO is explicitly set off in the batch file.  "No"
  7771.                    disables batch file echoing unless ECHO is explicitly set
  7772.                    on.  Also see SETDOS /V.
  7773.  
  7774.                    BeepFreq = nnnn  (440):  Sets the default BEEP command
  7775.                    frequency in Hz.  This is also the frequency for 4DOS
  7776.                    "error" beeps (if you press an illegal key, for example).
  7777.                    To disable all 4DOS error beeps set this or BeepLength to
  7778.                    0;  if you do the BEEP command will still be operable,
  7779.                    but will not produce sound unless you explicitly specify
  7780.                    the frequency and duration.
  7781.  
  7782.                    BeepLength = nnnn  (2):  Sets the default BEEP length in
  7783.                    system clock ticks (approximately 1/18 of a second per
  7784.                    tick).  BeepLength is also the default length for 4DOS
  7785.                    "error" beeps (if you press an illegal key, for example).
  7786.  
  7787.                    BrightBG = Yes | No.  Yes switches the video board to
  7788.                    display bright background colors rather than blinking
  7789.                    foreground colors within 4DOS.  No switches to blinking
  7790.                    foreground mode and disables bright backgrounds.  The
  7791.                    default if BrightBG is not used is to leave the video
  7792.  
  7793.  
  7794.           ___________________________________________________________________
  7795.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  129
  7796.  
  7797.                                                CHAPTER 6 / OPTIONS AND TUNING
  7798.           ___________________________________________________________________
  7799.  
  7800.  
  7801.                    board in its current state and not adjust the mode at
  7802.                    all.  If BrightBG is enabled and you use the Blink
  7803.                    keyword in a color specification, you will see bright
  7804.                    background colors instead.  If BrightBG is not enabled
  7805.                    and you use a bright background color specification, you
  7806.                    will see blinking text instead.  BrightBG is compatible
  7807.                    with most EGA and VGA video boards, but may cause screen
  7808.                    "flashes" at the prompt, or otherwise work improperly,
  7809.                    with some unusual or non-standard video systems.  If you
  7810.                    experience such problems after setting BrightBG, try
  7811.                    removing it from your 4DOS.INI file entirely.
  7812.  
  7813.                    CursorIns = nnnn  (100):  This is the shape of the cursor
  7814.                    for insert mode during command line editing and all
  7815.                    commands which accept line input (DESCRIBE, ESET, etc.).
  7816.                    The size is a percentage of the total character cell
  7817.                    size, between 0% and 100%.  Because of the way video
  7818.                    BIOSes map the cursor shape, you may not get a smooth
  7819.                    progression in cursor shapes as CursorIns and CursorOver
  7820.                    change.  Also see SETDOS /S.
  7821.  
  7822.                    CursorOver = nnnn  (10):  This is the shape of the cursor
  7823.                    for overtype mode during command line editing and all
  7824.                    commands which accept line input.  The size is a
  7825.                    percentage of the total character cell size, between 0%
  7826.                    and 100%.  Also see SETDOS /S.
  7827.  
  7828.                    CommandSep = c  (^):  This is the character used to
  7829.                    separate multiple commands on the same line.  You cannot
  7830.                    use any of the redirection characters (| > < ) or any of
  7831.                    the whitespace characters (space, tab, comma, or equal
  7832.                    sign).  Also see SETDOS /C.
  7833.  
  7834.                    DescriptionMax = nnnn (40):  Controls the description
  7835.                    length limit for DESCRIBE (see page 208).  The allowable
  7836.                    range is 20 to 120 characters.
  7837.  
  7838.                    EditMode = Insert | OVERSTRIKE:  This directive lets you
  7839.                    start the command line editor in either insert or
  7840.                    overstrike mode.  Also see SETDOS /M.
  7841.  
  7842.                    EscapeChar = c  (Ctrl-X):  Sets the character used to
  7843.                    suppress the normal meaning of the following character.
  7844.                    See page 94 for a description of the escape character and
  7845.                    special escape sequences.  You cannot use any of the
  7846.                    redirection characters (| > < ) or the whitespace
  7847.                    characters (space, tab, comma, or equal sign) as the
  7848.                    escape character.  Also see SETDOS /E.
  7849.  
  7850.  
  7851.           ___________________________________________________________________
  7852.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  130
  7853.  
  7854.                                                CHAPTER 6 / OPTIONS AND TUNING
  7855.           ___________________________________________________________________
  7856.  
  7857.  
  7858.                    HistMin = nnnn  (0):  Sets the minimum command line size
  7859.                    to save in the command history list.  Any command line
  7860.                    whose length is less than this value will not be saved.
  7861.                    Legal values range from 0 (save everything) to 256
  7862.                    (disable all command history saves).
  7863.  
  7864.                    HistWinHeight = nn (12):  Sets the height of the command
  7865.                    line history window in lines, including the border.
  7866.                    Legal values range from 5 to the height of your screen;
  7867.                    any value which would cause the bottom of the window to
  7868.                    be off the screen will be adjusted so that the entire
  7869.                    window remains on the screen.
  7870.  
  7871.                    HistWinLeft = nn (40):  Sets the horizontal position of
  7872.                    the left side of the command line history window.  Legal
  7873.                    values range from 0 (the left edge of the screen) to the
  7874.                    number of columns on your screen minus 10.  Any value
  7875.                    which would cause the right side of a minimum-width
  7876.                    window to be off the screen will be adjusted so that the
  7877.                    entire window remains on the screen.
  7878.  
  7879.                    HistWinTop = nn (1):  Sets the vertical position of the
  7880.                    top of the command line history window.  Legal values
  7881.                    range from 0 (the top of the screen) to the number of
  7882.                    rows on your screen minus 5.  Any value which would cause
  7883.                    the bottom of a minimum-height window to be off the
  7884.                    screen will be adjusted so that the entire window remains
  7885.                    on the screen.
  7886.  
  7887.                    HistWinWidth = nn (36):  Sets the width of the command
  7888.                    line history window in characters, including the border.
  7889.                    Legal values range from 10 to the width of your screen;
  7890.                    any value which would cause the right side of the window
  7891.                    to be off the screen will be adjusted so that the entire
  7892.                    window remains on the screen.
  7893.  
  7894.                    LineInput = Yes | NO:  This directive controls how 4DOS
  7895.                    gets its input from the command line.  "Yes" forces 4DOS
  7896.                    to use line input via the DOS service INT 21H 0AH "Get
  7897.                    Line" which is the way that COMMAND.COM gets input.  This
  7898.                    will disable command-line editing, history recall, and
  7899.                    filename completion, and is normally used only for rare
  7900.                    memory-resident programs (TSRs) which do not work
  7901.                    properly unless the command processor uses line input.
  7902.                    If you have a particular program that requires line
  7903.                    input, you can use SETDOS /L to temporarily change modes.
  7904.                    See APPNOTES.DOC for any specific programs which require
  7905.                    this option.
  7906.  
  7907.  
  7908.           ___________________________________________________________________
  7909.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  131
  7910.  
  7911.                                                CHAPTER 6 / OPTIONS AND TUNING
  7912.           ___________________________________________________________________
  7913.  
  7914.  
  7915.                    NoClobber = Yes | NO:  If set to Yes, will prevent
  7916.                    standard output redirection (see page 66) from
  7917.                    overwriting an existing file, and will require that the
  7918.                    output file already exist for append redirection.  Also
  7919.                    see SETDOS /N.
  7920.  
  7921.                    ParameterChar = c.  Sets the character used to specify
  7922.                    all or all remaining command line arguments.  The default
  7923.                    is "&" (as in "%&") for 4DOS and "$" (as in "%$") for
  7924.                    4OS2.  Also see SETDOS /P
  7925.  
  7926.                    ScreenRows = nnnn:  Sets the number of screen rows used
  7927.                    by the video display.  Normally, 4DOS detects the screen
  7928.                    size automatically, but if you have a non-standard
  7929.                    display you may need to set it explicitly.  This value
  7930.                    does not affect screen scrolling, which is controlled by
  7931.                    your video BIOS or ANSI driver.  ScreenRows is used only
  7932.                    by the LIST and SELECT commands, the paged output options
  7933.                    of other commands (e.g., TYPE /P), and error checking in
  7934.                    the screen output commands.  Also see SETDOS /R.
  7935.  
  7936.                    UpperCase = Yes | NO:  "Yes" specifies that filenames
  7937.                    should be displayed in the traditional upper-case by
  7938.                    internal commands like COPY and DIR.  "No" allows the
  7939.                    normal 4DOS lower-case style.  Also see SETDOS /U.
  7940.  
  7941.  
  7942.               Color Directives
  7943.  
  7944.               These directives control the colors that 4DOS uses for its
  7945.               displays.  Screen border colors can only be set in StdColors.
  7946.               "BORder" color specifications included in other directives
  7947.               will be ignored.
  7948.  
  7949.                    ColorDir = ext1 ext2 ...:colora;ext3 ext4 ... :colorb ...
  7950.                    (none):  Sets the directory colors.  The format is the
  7951.                    same as that used for the COLORDIR environment variable
  7952.                    (see DIR on page 210 or SELECT on page 296).  If you set
  7953.                    the COLORDIR environment variable it will override this
  7954.                    directive.  You may find it useful to use the COLORDIR
  7955.                    variable for experimenting, then to set permanent
  7956.                    directory colors with a ColorDir directive in 4DOS.INI.
  7957.  
  7958.                    HistWinColor = Color:  Sets the default colors for the
  7959.                    command line history window.  If this directive is not
  7960.                    used the colors will be reversed from the current colors
  7961.                    on the screen.
  7962.  
  7963.  
  7964.  
  7965.           ___________________________________________________________________
  7966.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  132
  7967.  
  7968.                                                CHAPTER 6 / OPTIONS AND TUNING
  7969.           ___________________________________________________________________
  7970.  
  7971.  
  7972.                    ListColors = Color:  Sets the colors used by the LIST and
  7973.                    SELECT commands.  If this directive is not used, LIST and
  7974.                    SELECT will use the current default colors set by the CLS
  7975.                    or COLOR command or by the StdColors directive, below.
  7976.  
  7977.                    StdColors = Color:  Sets the standard colors to be used
  7978.                    when CLS is used without a color specification, and for
  7979.                    LIST and SELECT if ListColors is not used.  Using this
  7980.                    directive is similar to placing a COLOR command in
  7981.                    AUTOEXEC.BAT.  StdColors takes effect the first time CLS,
  7982.                    LIST, or SELECT is used after the transient portion of
  7983.                    4DOS starts (i.e., when 4START is run).  However it will
  7984.                    not affect the color of error or other messages displayed
  7985.                    during the 4DOS loading and initialization process.  If
  7986.                    ANSI.SYS or a compatible driver is not loaded, the colors
  7987.                    will not be "sticky" -- you may lose them when you run an
  7988.                    application.
  7989.  
  7990.  
  7991.               Key Mapping Directives
  7992.  
  7993.               The directives in this group allow you to change the keys used
  7994.               for 4DOS command line editing and other internal functions.
  7995.               They take effect only inside 4DOS itself and do not affect
  7996.               other programs (including 4DOS's external help program,
  7997.               4HELP.EXE).
  7998.  
  7999.               The description of each directive below explains the function
  8000.               of the corresponding key.  Using the directive allows you to
  8001.               assign a different or additional key to perform the function
  8002.               described.  For example, to assign function key F3 to invoke
  8003.               the 4DOS HELP facility:
  8004.  
  8005.                    Help = F3
  8006.  
  8007.               Any directive can be used multiple times to assign multiple
  8008.               keys to the same function.  For example:
  8009.  
  8010.                    ListFind = F         ;F does a find in LIST
  8011.                    ListFind = F5        ;F5 also does a find in LIST
  8012.  
  8013.               Use some care when you reassign keystrokes.  If you assign a
  8014.               default key to a different function, it will no longer be
  8015.               available for its original use.  For example, if you assign F1
  8016.               to the AddFile directive (a part of filename completion), the
  8017.               F1 key will no longer invoke 4DOS's HELP facility, so you will
  8018.               probably want to assign a different key to HELP.
  8019.  
  8020.  
  8021.  
  8022.           ___________________________________________________________________
  8023.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  133
  8024.  
  8025.                                                CHAPTER 6 / OPTIONS AND TUNING
  8026.           ___________________________________________________________________
  8027.  
  8028.  
  8029.               Some keys are interpreted by your system's BIOS and are not
  8030.               passed on to 4DOS.  For example, Ctrl-S tells the BIOS to
  8031.               pause screen output temporarily, and on some systems Ctrl-P
  8032.               toggles Print Screen mode.  Keys which are interpreted by the
  8033.               BIOS cannot be assigned with key mapping directives, because
  8034.               4DOS never receives these keystrokes and therefore cannot act
  8035.               on them.
  8036.  
  8037.               You may not be able to remap F11 and F12 if your keyboard is
  8038.               not 100% IBM-compatible, or if you have an ANSI driver which
  8039.               does not support these keys.  This limitation is due to DOS
  8040.               and your ANSI driver, and is not inherent in 4DOS.
  8041.  
  8042.               4DOS processes all command line editing key assignments before
  8043.               looking for keystroke aliases.  For example, if you assign
  8044.               Shift-F1 to HELP and also assign Shift-F1 to a key alias, the
  8045.               key alias will be ignored.
  8046.  
  8047.               Assigning a new keystroke for a function does not deassign the
  8048.               default keystroke for the same function.  If you want to
  8049.               deassign one of the standard 4DOS keys without assigning it to
  8050.               another function, use the NormalKey directive described below
  8051.               or the corresponding directive for keys in the other key
  8052.               groups (NormalEditKey, NormalHWinKey, or NormalListKey).
  8053.  
  8054.               There are three pre-mapped keys:  Tab and Shift-Tab (mapped to
  8055.               NextFile and PrevFile respectively) and Ctrl-Bksp (mapped to
  8056.               DelWordRight).  If you need to clear out these assignments so
  8057.               you can assign Tab, Shift-Tab, or Ctrl-Bksp to a keystroke
  8058.               alias, use the ClearKeyMap directive, described in Advanced
  8059.               Directives below.
  8060.  
  8061.               General Input Keys
  8062.  
  8063.                    This first set of Key Mapping Directives applies to all
  8064.                    input.  These directives are effective whenever 4DOS
  8065.                    requests input from the keyboard, including command line
  8066.                    editing and the DESCRIBE, ESET, INPUT, LIST, and SELECT
  8067.                    commands.  (Scrolling through the command history list is
  8068.                    controlled by NextHist and PrevHist (see page 136), not
  8069.                    by the Up and Down directives below.)  See page 55 for
  8070.                    more information about command line editing.
  8071.  
  8072.                    Backspace = Key  (Bksp):  Deletes the character to the
  8073.                    left of the cursor.
  8074.  
  8075.                    BeginLine = Key  (Home):  Moves the cursor to the
  8076.                    beginning of the line.
  8077.  
  8078.  
  8079.           ___________________________________________________________________
  8080.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  134
  8081.  
  8082.                                                CHAPTER 6 / OPTIONS AND TUNING
  8083.           ___________________________________________________________________
  8084.  
  8085.  
  8086.                    Del = Key  (Del):  Deletes the character at the cursor.
  8087.  
  8088.                    DelToBeginning = Key (Ctrl-Home):  Deletes from the
  8089.                    cursor to the start of the line.
  8090.  
  8091.                    DelToEnd = Key (Ctrl-End):  Deletes from the cursor to
  8092.                    the end of the line.
  8093.  
  8094.                    DelWordLeft = Key  (Ctrl-L):  Deletes the word to the
  8095.                    left of the cursor.
  8096.  
  8097.                    DelWordRight = Key  (Ctrl-R, Ctrl-Bksp):  Deletes the
  8098.                    word to the right of the cursor.  See ClearKeyMap in
  8099.                    Advanced Directives below if you need to remove the
  8100.                    mapping of Ctrl-Bksp to this function.
  8101.  
  8102.                    Down = Key  (Down):  Scrolls the display down one line in
  8103.                    LIST; moves the cursor down one line in SELECT and in the
  8104.                    command history window.
  8105.  
  8106.                    EndLine = Key  (End):  Moves the cursor to the end of the
  8107.                    line.
  8108.  
  8109.                    EraseLine = Key  (Esc):  Deletes the entire line.
  8110.  
  8111.                    ExecLine = Key (Enter):  Executes or accepts a line.
  8112.  
  8113.                    Ins = Key (Ins):  Toggles insert / overstrike mode during
  8114.                    line editing.
  8115.  
  8116.                    Left = Key  (Left):  Moves the cursor left one character;
  8117.                    moves the display left 8 columns in LIST.
  8118.  
  8119.                    NormalKey = Key:  Deassigns a general input key in order
  8120.                    to disable the usual meaning of the key within 4DOS and /
  8121.                    or make it available for keystroke aliases.  This will
  8122.                    cause 4DOS to treat the keystroke as a "normal" key with
  8123.                    no special function.  For example:
  8124.  
  8125.                         NormalKey = Ctrl-End
  8126.  
  8127.                    will disable Ctrl-End, which is the standard "delete to
  8128.                    beginning of line" key.  Ctrl-End could then be assigned
  8129.                    to a keystroke alias.  Another key could be assigned the
  8130.                    "delete to end of line" function with the DelToEnd
  8131.                    directive (above).
  8132.  
  8133.  
  8134.  
  8135.  
  8136.           ___________________________________________________________________
  8137.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  135
  8138.  
  8139.                                                CHAPTER 6 / OPTIONS AND TUNING
  8140.           ___________________________________________________________________
  8141.  
  8142.  
  8143.                    Right = Key  (Right):  Moves the cursor right one
  8144.                    character;  scrolls the display right 8 columns in LIST.
  8145.  
  8146.                    Up = Key  (Up):  Scrolls the display up one line in LIST;
  8147.                    moves the cursor up one line in SELECT and in the command
  8148.                    history window.
  8149.  
  8150.                    WordLeft = Key  (Ctrl-Left):  Moves the cursor left one
  8151.                    word;  scrolls the display left 40 columns in LIST.
  8152.  
  8153.                    WordRight = Key  (Ctrl-Right):  Moves the cursor right
  8154.                    one word;  scrolls the display right 40 columns in LIST.
  8155.  
  8156.  
  8157.               Command Line Editing Keys
  8158.  
  8159.                    The following directives apply only to command line
  8160.                    editing.  They are only effective at the 4DOS prompt.
  8161.  
  8162.                    AddFile = Key  (F10):  Keeps the current filename
  8163.                    completion entry and inserts the next matching name.
  8164.  
  8165.                    CommandEscape = Key  (Alt-255):  Allows direct entry of a
  8166.                    keystroke that would normally be interpreted as an editor
  8167.                    command.
  8168.  
  8169.                    DelHistory = Key  (Ctrl-D):  Deletes the displayed
  8170.                    history list entry and displays the previous entry.
  8171.  
  8172.                    EndHistory = Key  (Ctrl-E):  Displays the last entry in
  8173.                    the history list.
  8174.  
  8175.                    Help = Key  (F1):  Invokes the 4DOS HELP facility.
  8176.  
  8177.                    NextFile = Key  (F9, Tab):  Gets the next matching
  8178.                    filename.  See ClearKeyMap in Advanced Directives below
  8179.                    if you need to remove the mapping of Tab to this
  8180.                    function.
  8181.  
  8182.                    NextHistory = Key  (Down):  Recalls the next command from
  8183.                    the command history.
  8184.  
  8185.                    NormalEditKey = Key:  Deassigns a command line editing
  8186.                    key in order to disable the usual meaning of the key
  8187.                    while editing a command line and / or make it available
  8188.                    for keystroke aliases.  This will cause 4DOS to treat the
  8189.                    keystroke as a "normal" key with no special function.
  8190.                    For an example see the NormalKey directive on page 135.
  8191.  
  8192.  
  8193.           ___________________________________________________________________
  8194.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  136
  8195.  
  8196.                                                CHAPTER 6 / OPTIONS AND TUNING
  8197.           ___________________________________________________________________
  8198.  
  8199.  
  8200.                    PrevFile = Key  (F8, Shift-Tab):  Gets the previous
  8201.                    matching filename.  See ClearKeyMap in Advanced
  8202.                    Directives below if you need to remove the mapping of
  8203.                    Shift-Tab to this function.
  8204.  
  8205.                    PrevHistory = Key  (Up):  Recalls the previous command
  8206.                    from the command history.
  8207.  
  8208.                    SaveHistory = Key  (Ctrl-K):  Saves the command line in
  8209.                    the history list without executing it.
  8210.  
  8211.  
  8212.               History Window Keys
  8213.  
  8214.                    HistWinBegin = Key (Ctrl-PgUp):  Moves to the first line
  8215.                    of the history when in the history window.
  8216.  
  8217.                    HistWinDel = Key (Ctrl-D):  Deletes a line from within
  8218.                    the history window.
  8219.  
  8220.                    HistWinEdit = Key (Ctrl-Enter):  Moves a line from the
  8221.                    history window to the prompt for editing.
  8222.  
  8223.                    HistWinEnd = Key (Ctrl-PgDn):  Moves to the last line of
  8224.                    the history when in the history window.
  8225.  
  8226.                    HistWinExec = Key (Enter):  Executes the selected line in
  8227.                    the history window.
  8228.  
  8229.                    HistWinOpen = Key (PgUp):  Brings up the history window
  8230.                    while at the command line.
  8231.  
  8232.                    NormalHWinKey = Key:  Deassigns a history window key in
  8233.                    order to disable the usual meaning of the key within the
  8234.                    history window.  This will cause 4DOS to treat the
  8235.                    keystroke as a "normal" key with no special function.
  8236.                    For an example see the NormalKey directive on page 135.
  8237.  
  8238.  
  8239.               LIST Keys
  8240.  
  8241.                    The keys in the last group of Key Mapping Directives are
  8242.                    effective only inside the LIST command.
  8243.  
  8244.                    ListFind = Key  (F):  Prompts and searches for a string.
  8245.  
  8246.  
  8247.  
  8248.  
  8249.  
  8250.           ___________________________________________________________________
  8251.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  137
  8252.  
  8253.                                                CHAPTER 6 / OPTIONS AND TUNING
  8254.           ___________________________________________________________________
  8255.  
  8256.  
  8257.                    ListHighBit = Key (H):  Toggles LIST's "strip high bit"
  8258.                    option, which can aid in displaying files from certain
  8259.                    word processors.
  8260.  
  8261.                    ListNext = Key  (N):  Finds the next matching string.
  8262.  
  8263.                    ListPrint = Key  (P):  Prints the file on LPT1.
  8264.  
  8265.                    ListWrap = Key (W):  Toggles LIST's wrap option on and
  8266.                    off.  The wrap option wraps text at the right margin.
  8267.  
  8268.                    NormalListKey = Key (none):  Deassigns a LIST key in
  8269.                    order to disable the usual meaning of the key within
  8270.                    LIST.  This will cause 4DOS to treat the keystroke as a
  8271.                    "normal" key with no special function.  For an example
  8272.                    see the NormalKey directive on page 135.
  8273.  
  8274.  
  8275.               Advanced Directives
  8276.  
  8277.               These directives are generally used for unusual circumstances,
  8278.               or for diagnosing problems.  Most often they are not needed in
  8279.               normal use.
  8280.  
  8281.                    ChangeTitle = YES | No:  Determines whether 4DOS changes
  8282.                    the OS/2 session title when running an external program
  8283.                    from an OS/2 2.x DOS session.
  8284.  
  8285.                    ClearKeyMap:  Clears all current key mappings.
  8286.                    ClearKeyMap is a special directive which has no value or
  8287.                    "=" after it.  Use ClearKeyMap to make one of the keys in
  8288.                    4DOS's default map (Tab, Shift-Tab, or Ctrl-Bksp)
  8289.                    available for a keystroke alias; or in the [Secondary]
  8290.                    section to clear key mappings inherited from the primary
  8291.                    shell.  ClearKeyMap should appear before any other key
  8292.                    mapping directives.  If you only need to clear some of
  8293.                    the default mappings, use ClearKeyMap, then recreate the
  8294.                    mappings you want to retain (e.g. with "Tab=NextFile",
  8295.                    etc.).
  8296.  
  8297.                    CopyEA = YES | No:  Determines whether the 4DOS COPY and
  8298.                    MOVE commands attempt to copy extended attributes when
  8299.                    running in an OS/2 1.x or 2.x DOS session.
  8300.  
  8301.                    CritFail = Yes | NO:  This is the same as /F on the SHELL
  8302.                    = line in CONFIG.SYS.  It intercepts all DOS critical
  8303.                    errors and returns a Fail to each.  We do not recommend
  8304.                    this on a normal system, because you will not have a
  8305.  
  8306.  
  8307.           ___________________________________________________________________
  8308.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  138
  8309.  
  8310.                                                CHAPTER 6 / OPTIONS AND TUNING
  8311.           ___________________________________________________________________
  8312.  
  8313.  
  8314.                    chance to react to a critical error and correct the
  8315.                    problem that caused it.  It is intended for use on
  8316.                    bulletin boards or other systems where unattended
  8317.                    operation is required without user prompts.
  8318.  
  8319.                    DiskReset = Yes | NO:  Enables or disables disk resets
  8320.                    after COPY, DEL/ERASE, DESCRIBE, MOVE, and REN/RENAME,
  8321.                    and before DIR.  Set to Yes if you have problems with
  8322.                    disk change detection on non-standard or cached floppy
  8323.                    disk drives, or with network software which doesn't
  8324.                    always properly flush data to the disk.  Such problems
  8325.                    are very, rare so normally No is the best choice.
  8326.                    Setting DiskReset to Yes may reduce the performance of
  8327.                    DIR, COPY, MOVE, and RENAME when using a "staged-write"
  8328.                    disk cache such as Microsoft SmartDrive 4.0.
  8329.  
  8330.                    DRSets = YES | No.  When running under DR-DOS, 4DOS will
  8331.                    normally retrieve environment variables created by any
  8332.                    SET commands in the DR-DOS CONFIG.SYS file and place them
  8333.                    in the 4DOS master environment.  Set DRSets to No to
  8334.                    disable this feature.
  8335.  
  8336.                    DVCleanup = YES | No.  No disables 4DOS's DESQview close
  8337.                    window cleanup code and thereby reenables the Quit choice
  8338.                    on the DESQview menu when at a 4DOS prompt.  This will
  8339.                    prevent 4DOS from cleaning up its resources (releasing
  8340.                    the shell number and deleting any disk swap file) when
  8341.                    you Close a 4DOS window from the DESQview menu, rather
  8342.                    than with the EXIT command.
  8343.  
  8344.                    FineSwap = Yes | NO:  "Yes" enables "fine-grained"
  8345.                    checksums during disk swapping.  This should be used only
  8346.                    to diagnose unusual swapping problems.
  8347.  
  8348.                    FullINT2E = Yes | NO:  Enables full support for the
  8349.                    COMMAND.COM "back door" (interrupt 2E) which a few
  8350.                    programs use to execute commands.  Effective only in a
  8351.                    primary shell loaded via the SHELL= command in
  8352.                    CONFIG.SYS.  See Appendix C on page 348 below for details
  8353.                    on using INT 2E.  Also, see APPNOTES.DOC for information
  8354.                    on any programs known to require this option.  If this
  8355.                    directive is not used or is set to NO, INT 2E will return
  8356.                    immediately to the calling program without taking any
  8357.                    action.  Setting FullINT2E to YES adds about 100 bytes to
  8358.                    the resident size of the primary shell.
  8359.  
  8360.  
  8361.  
  8362.  
  8363.  
  8364.           ___________________________________________________________________
  8365.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  139
  8366.  
  8367.                                                CHAPTER 6 / OPTIONS AND TUNING
  8368.           ___________________________________________________________________
  8369.  
  8370.  
  8371.                    Inherit = YES | No:  Aliases and the history list are
  8372.                    normally passed to secondary shells automatically.  "No"
  8373.                    disables this feature.
  8374.  
  8375.                    MessageServer = YES | No:  For compatibility with
  8376.                    COMMAND.COM in MS-DOS 4.x and 5.x, 4DOS includes a
  8377.                    "message server" that retrieves error message text for
  8378.                    DOS external commands like DISKCOPY and FORMAT.  The
  8379.                    message server increases the size of the resident portion
  8380.                    of 4DOS by about 200 bytes.  "No" disables the message
  8381.                    server and saves this space, but will cause more cryptic
  8382.                    error messages such as "Parse error 3" or "Extended error
  8383.                    7" from some DOS external commands.  The message server
  8384.                    is automatically disabled by 4DOS except in the primary
  8385.                    4DOS shell loaded from CONFIG.SYS when running under DOS
  8386.                    4.x or 5.x.
  8387.  
  8388.                    NetwareNames = Yes | NO.  Set to Yes to include strings
  8389.                    in the resident portion of 4DOS which Novell Netware
  8390.                    searches for when it loads.  NetwareNames should be Yes
  8391.                    for Netware systems to avoid problems with destroyed
  8392.                    environment variables during LOGIN.  If NetwareNames is
  8393.                    set to Yes and you boot from a Netware drive (a rare
  8394.                    situation), the TEMP4DOS or TEMP variables must be SET
  8395.                    explicitly to the appropriate drive and directory for
  8396.                    each user to avoid conflicts with pipe files (in all
  8397.                    other circumstances, 4DOS and Netware will automatically
  8398.                    set the proper drive and directory for pipe files).
  8399.  
  8400.                    NextINIFile = File.  Full path and name must be
  8401.                    specified.  All subsequent shells will read the specified
  8402.                    INI file, and ignore any [Secondary] section in the
  8403.                    original 4DOS.INI.  Intended to allow diskless or floppy-
  8404.                    only workstation users to shift 4DOS.INI to a network
  8405.                    drive for secondary shells, and avoid all access to the
  8406.                    original boot drive.
  8407.  
  8408.                    Reduce = YES | No:  Set to "No" to disable the smaller
  8409.                    swap size used by 4DOS secondary shells.  For diagnosing
  8410.                    unusual swapping problems only.
  8411.  
  8412.                    ReserveTPA = YES | No:  Set to "No" to prevent 4DOS from
  8413.                    reserving memory for its transient portion while at the
  8414.                    command prompt.  For diagnosing unusual TSR or swapping
  8415.                    problems only.  ReserveTPA is forced to YES regardless of
  8416.                    any INI file setting if you are running under Windows 3
  8417.                    in real or standard mode.  This is necessary to avoid
  8418.                    undesirable interactions between 4DOS and Windows.
  8419.  
  8420.  
  8421.           ___________________________________________________________________
  8422.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  140
  8423.  
  8424.                                                CHAPTER 6 / OPTIONS AND TUNING
  8425.           ___________________________________________________________________
  8426.  
  8427.  
  8428.                    StackSize= nnnn (4096):  Set the 4DOS internal stack
  8429.                    size.  The allowable range of values is 4096 to 8192.
  8430.                    You may need to increase the stack size if you are using
  8431.                    extremely complex combinations of batch files and nested
  8432.                    "prefix" commands like EXCEPT, FOR, GLOBAL, IF, and
  8433.                    SELECT on the same command line, and you receive a "4DOS
  8434.                    internal stack overflow" error.  For virtually all users
  8435.                    the default stack size will be sufficient.  Increasing
  8436.                    this value also increases the size of 4DOS's transient
  8437.                    portion and the size of the 4DOS swap area.
  8438.  
  8439.                    SwapReopen = Yes | NO:  Set to "Yes" to enable reopening
  8440.                    of the 4DOS swap file if it is closed by another program.
  8441.                    This is required when swapping 4DOS to Novell Netware
  8442.                    drives or when using other applications which close
  8443.                    4DOS's swap file.  In all other circumstances, it is only
  8444.                    useful for diagnostic purposes.  Setting SwapReopen to
  8445.                    "Yes" also disables the reduced swapping size normally
  8446.                    used in 4DOS secondary shells.
  8447.  
  8448.                    UniqueSwapName = Yes | No.  Set to Yes to change the disk
  8449.                    swap file name from 4DOSSWAP.nnn to a unique name
  8450.                    generated by 4DOS, with an extension of "4SW" (eg
  8451.                    a1gd6nnw.4sw).  This prevents conflicts between swap
  8452.                    files in different shells; it is only necessary when you
  8453.                    are using disk swapping with a COMMAND.COM primary shell
  8454.                    or in an OS/2 2.x DOS session.  The default is Yes in
  8455.                    OS/2 2.x DOS sessions and No elsewhere.  UniqueSwapName
  8456.                    only works in DOS 3.0 and above and applies only to disk
  8457.                    swapping.
  8458.  
  8459.  
  8460.               Examples
  8461.  
  8462.               The following examples will give you an idea of the types of
  8463.               things that can be done with the 4DOS.INI file.  The comments
  8464.               on each directive explain what it does.
  8465.  
  8466.               First, a very simple example that just sets up swapping and
  8467.               environment size, leaving everything else at its default
  8468.               value:
  8469.  
  8470.                    Swapping = ems, c:\
  8471.                                                   ;try EMS, then C: root
  8472.                    Environment = 1024             ;set environment size
  8473.  
  8474.               Here's something a little fancier that changes a number of the
  8475.               default settings:
  8476.  
  8477.  
  8478.           ___________________________________________________________________
  8479.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  141
  8480.  
  8481.                                                CHAPTER 6 / OPTIONS AND TUNING
  8482.           ___________________________________________________________________
  8483.  
  8484.  
  8485.                    Swapping = xms, h:\, c:\
  8486.                                                   ;try XMS, then RAM disk,
  8487.                                                   ;  then C: root
  8488.                    Environment = 1792             ;set env size
  8489.                    Alias = 6144                   ;set alias size
  8490.                    History = 1024                 ;set history size
  8491.                    UmbEnv=Y                       ;master environment in UMB
  8492.                    BatchEcho = No                 ;default is ECHO OFF
  8493.                    EditMode = Insert              ;editor in insert mode
  8494.                    CursorO = 100                  ;overstrike cursor 100%
  8495.                    CursorI = 10                   ;insert cursor 10%
  8496.  
  8497.               The final example is similar to the second, but includes key
  8498.               reassignments and a [Secondary] section to vary a couple of
  8499.               settings in secondary shells:
  8500.  
  8501.                    ; ALL SHELLS
  8502.                    PauseOnError = No              ;don't stop on an error
  8503.                    Swapping = xms, c:\
  8504.                                                   ;try XMS, then C: root
  8505.                    Environment = 1792             ;set env size
  8506.                    Alias = 6144                   ;set alias size
  8507.                    History = 1024                 ;set history size
  8508.                    UmbEnv=Y                       ;master environment in UMB
  8509.                    BatchEcho = No                 ;default is ECHO OFF
  8510.                    EditMode = Insert              ;editor in insert mode
  8511.                    CursorO = 100                  ;overstrike cursor 100%
  8512.                    ListFind = F5                  ;set LIST find to F5
  8513.                    ListNext = F6                  ;find next is F6
  8514.                    ListPrint = F7                 ;print file is F7
  8515.                    ;     PRIMARY SHELL ONLY
  8516.                    [Primary]                      ;set primaries
  8517.                    CursorI = 10                   ;insert cursor 10%
  8518.                    StdColors = bri whi on blu     ;set primary's colors
  8519.                    ;     SECONDARY SHELL ONLY
  8520.                    [Secondary]                    ;set secondaries
  8521.                    CursorI = 30                   ;insert cursor 30%
  8522.                    StdColors = bri whi on cya     ;set secondary's colors
  8523.  
  8524.  
  8525.  
  8526.  
  8527.  
  8528.  
  8529.  
  8530.  
  8531.  
  8532.  
  8533.  
  8534.  
  8535.           ___________________________________________________________________
  8536.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  142
  8537.  
  8538.                        CHAPTER 7 / USING 4DOS WITH YOUR HARDWARE AND SOFTWARE
  8539.           ___________________________________________________________________
  8540.  
  8541.  
  8542.  
  8543.           CHAPTER 7 / USING 4DOS WITH YOUR HARDWARE AND SOFTWARE
  8544.  
  8545.  
  8546.           This section of the manual explains how to get the most from 4DOS
  8547.           with your particular system.  A few general techniques and concepts
  8548.           are explained here, but if you have questions about how to make
  8549.           4DOS run most efficiently with a particular hardware setup or a
  8550.           specific application, you should also see the file called
  8551.           APPNOTES.DOC which comes with 4DOS.
  8552.  
  8553.           If you have questions about some of the terms and concepts here,
  8554.           see Chapter 4 / General Concepts on page 41, the Glossary on page
  8555.           355, and the Index.
  8556.  
  8557.           This section begins with a discussion of hardware considerations
  8558.           and includes some tips for installing 4DOS most effectively to run
  8559.           with several types of software, as well as certain popular
  8560.           programs.  It concludes with some techniques for resolving
  8561.           unintended interactions between programs, even if those
  8562.           interactions do not include 4DOS itself.
  8563.  
  8564.  
  8565.           Hardware
  8566.  
  8567.  
  8568.               The CPU
  8569.  
  8570.               The CPU or "Central Processing Unit" is the chip which
  8571.               performs or directs all of the work done by your computer.
  8572.               All PC CPU chips are part of or compatible with Intel's
  8573.               "80x86" family.  These include the 8088, 8086, 80188, 80186,
  8574.               80286, 386, 486, NEC V20, and NEC V30, plus "SX" versions and
  8575.               other variations of some of those chips.  4DOS is compatible
  8576.               with and will run equally well on all of these chips.
  8577.  
  8578.               Some systems have a numeric coprocessor as a companion to the
  8579.               CPU.  The numeric coprocessor performs many arithmetic
  8580.               calculations faster than the CPU.  4DOS does not use or access
  8581.               the numeric coprocessor in any way.
  8582.  
  8583.               You can determine which CPU chip your system has by using
  8584.               4DOS's _CPU internal variable:
  8585.  
  8586.                    c:\> echo %_cpu
  8587.  
  8588.               Similarly, you can find out if you have a numeric coprocessor
  8589.               with _NDP:
  8590.  
  8591.  
  8592.           ___________________________________________________________________
  8593.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  143
  8594.  
  8595.                        CHAPTER 7 / USING 4DOS WITH YOUR HARDWARE AND SOFTWARE
  8596.           ___________________________________________________________________
  8597.  
  8598.  
  8599.                    c:\> echo %_ndp
  8600.  
  8601.               See page 82 for details about _CPU and _NDP.
  8602.  
  8603.  
  8604.               Memory
  8605.  
  8606.               4DOS does its best to detect and properly access all types of
  8607.               memory that your computer can have:  Base memory, Expanded
  8608.               (EMS) Memory, Extended (XMS) Memory, and Upper Memory Blocks
  8609.               (UMBs).  4DOS always uses standard, documented methods to use
  8610.               the memory that you have installed.
  8611.  
  8612.               4DOS uses base memory (the area from 0 to 640K on most
  8613.               machines, which is sometimes called "low memory" or "DOS
  8614.               memory") for its resident portion and the master environment,
  8615.               and to hold its transient portion while your system is at the
  8616.               command prompt or executing a 4DOS command or batch file.
  8617.               4DOS may use EMS memory or an XMS Extended Memory Block (EMB)
  8618.               to swap its transient portion, according to the Swapping
  8619.               directive in your 4DOS.INI file (see page 126).
  8620.  
  8621.               4DOS uses UMBs for several purposes:
  8622.  
  8623.                    *  to move the 4DOS resident portion out of base memory,
  8624.                       if you specify "UMBLoad = Yes" in your 4DOS.INI file.
  8625.  
  8626.                    *  to move the master environment out of base memory, if
  8627.                       you specify "UMBEnvironment = Yes" in your 4DOS.INI
  8628.                       file.
  8629.  
  8630.                    *  to load memory-resident programs (TSRs) "high" using
  8631.                       the LOADHIGH or LH command under MS-DOS 5.0.
  8632.  
  8633.               To load 4DOS or the master environment into a UMB, you must be
  8634.               using a memory manager or XMS driver which provides both the
  8635.               ability to remap memory into the area between 640K and 1MB (to
  8636.               create the UMBs) and XMS or DOS 5.0 UMB support (to manage the
  8637.               UMBs).  These are generally the same requirements which must
  8638.               be met to load TSRs "high."
  8639.  
  8640.               To give 4DOS access to UMBs, you need hardware and software
  8641.               combinations like the following:
  8642.  
  8643.  
  8644.  
  8645.  
  8646.  
  8647.  
  8648.  
  8649.           ___________________________________________________________________
  8650.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  144
  8651.  
  8652.                        CHAPTER 7 / USING 4DOS WITH YOUR HARDWARE AND SOFTWARE
  8653.           ___________________________________________________________________
  8654.  
  8655.  
  8656.               386 and 486 systems (including 386SX computers):
  8657.  
  8658.                    Hardware:  Sufficient installed RAM.
  8659.  
  8660.                    Software:  Qualitas' 386MAX or Blue Max, Quarterdeck's
  8661.                    QEMM 5.0 or later, DOS 5.0's EMM386.SYS, or a similar 386
  8662.                    memory manager.  HIMEM.SYS alone is not sufficient.
  8663.  
  8664.               80286 systems:
  8665.  
  8666.                    Hardware:  Chips and Technologies NEAT chip set, or an
  8667.                    EMS 4.0 or EEMS memory board, plus sufficient installed
  8668.                    RAM.
  8669.  
  8670.                    Software:  Qualitas' MOVE-EM 1.02 or later with
  8671.                    Microsoft's HIMEM.SYS, or Quarterdeck's QRAM and QEXT.
  8672.  
  8673.               Other memory-management software may also work.  The lists
  8674.               above are examples only.  On the 386 systems here at JP
  8675.               Software, we use 386MAX almost exclusively, but we also have
  8676.               had good results with QEMM.  Look for specific information
  8677.               about your memory management program in APPNOTES.DOC.
  8678.  
  8679.               If you want to use the 4DOS LOADHIGH command as well as put
  8680.               4DOS and the master environment in high memory, you must also
  8681.               be running MS-DOS 5.0 or above.
  8682.  
  8683.               4DOS never accesses extended memory directly.  It always uses
  8684.               an XMS driver like HIMEM.SYS, EMM386.SYS, 386MAX, QEXT, or
  8685.               QEMM.  4DOS can also access any RAM disk you create in
  8686.               extended memory by using a program like VDISK.SYS or
  8687.               RAMDRIVE.SYS.  4DOS does not use the XMS "High Memory Area"
  8688.               (HMA), a 64K byte area just above 1 MB on 80286, 386, and 486
  8689.               systems.
  8690.  
  8691.               If you want to know whether 4DOS sees your system's memory
  8692.               accurately, check the output of the MEMORY command.  It should
  8693.               correspond to your computer's memory configuration.
  8694.  
  8695.               The MEMORY command's output depends to some extent on your
  8696.               memory manager.  If you are using Quarterdeck's QEMM, the
  8697.               report may not be the same as you expect.  Because QEMM turns
  8698.               your extended memory into either XMS or EMS memory as
  8699.               required, the same memory is shown both ways in the MEMORY
  8700.               report.  If 1 MB of extended memory managed by QEMM is
  8701.               available, MEMORY will report 1 MB of free XMS memory and 1 MB
  8702.               of free EMS memory as well, even though it is all the same
  8703.               memory.  This is not a bug but a result of QEMM's flexibility.
  8704.  
  8705.  
  8706.           ___________________________________________________________________
  8707.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  145
  8708.  
  8709.                        CHAPTER 7 / USING 4DOS WITH YOUR HARDWARE AND SOFTWARE
  8710.           ___________________________________________________________________
  8711.  
  8712.  
  8713.               Memory-related problems with 4DOS are usually due to programs
  8714.               which overwrite the extended memory block (EMB) that 4DOS uses
  8715.               for swapping its transient portion.  When you exit from such a
  8716.               program, your system will hang, because 4DOS tried to swap
  8717.               itself back into base memory but its code and data in XMS have
  8718.               been destroyed by the program.  The same problem can occur
  8719.               with EMS swapping but is less common because EMS memory is
  8720.               generally better defended against wayward programs.  You can
  8721.               diagnose this kind of problem easily by changing to disk
  8722.               swapping with the 4DOS.INI Swapping directive, and rebooting.
  8723.               If the problem goes away with disk swapping, then the program
  8724.               in question is probably destroying 4DOS's swap area in XMS or
  8725.               EMS memory.
  8726.  
  8727.               4DOS EMS swapping sometimes has difficulty with EMS drivers
  8728.               which do not fully meet the EMS 3.2 specification (4DOS
  8729.               supports, but does not require, EMS 4.0 drivers).  If you have
  8730.               trouble accessing EMS for swapping, check APPNOTES.DOC to see
  8731.               if there are any known problems with your EMS board or the
  8732.               associated driver software.
  8733.  
  8734.  
  8735.               Video
  8736.  
  8737.               4DOS is compatible with most display adapters and monitors.
  8738.               Although 4DOS can normally detect your video parameters
  8739.               automatically, you may have to configure it to use the system
  8740.               most efficiently.
  8741.  
  8742.               4DOS uses two methods of displaying text on the screen:
  8743.  
  8744.                    *  4DOS calls DOS to write the text of prompts and normal
  8745.                       messages.  If you use an ANSI driver, DOS will transmit
  8746.                       the calls to it.  Otherwise, DOS will use your BIOS to
  8747.                       display text on the screen.  DOS text display calls
  8748.                       will work on all DOS systems, regardless of video type.
  8749.  
  8750.                    *  The DRAWBOX, DRAWHLINE, DRAWVLINE, LIST, SELECT,
  8751.                       SCRPUT, and VSCRPUT commands bypass DOS, the BIOS, and
  8752.                       any ANSI driver.  They write directly to video memory.
  8753.                       These commands will only work on systems with 100% IBM-
  8754.                       compatible video systems.  On other computers, results
  8755.                       will be unpredictable at best.  If you have such a
  8756.                       system you probably know it already, because most
  8757.                       application programs have similar problems.
  8758.  
  8759.               EGA and VGA systems can display text in standard 25-line mode,
  8760.               plus modes with 43, 50, or more lines.  4DOS normally detects
  8761.  
  8762.  
  8763.           ___________________________________________________________________
  8764.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  146
  8765.  
  8766.                        CHAPTER 7 / USING 4DOS WITH YOUR HARDWARE AND SOFTWARE
  8767.           ___________________________________________________________________
  8768.  
  8769.  
  8770.               the number of lines automatically.  If it doesn't, you can use
  8771.               the 4DOS.INI ScreenRows directive or the SETDOS /R command to
  8772.               set the 4DOS screen length.    4DOS uses ScreenRows or SETDOS
  8773.               /R to set the display length that it uses for the LIST and
  8774.               SELECT command, as well as commands that have a "pause" option
  8775.               (TYPE /P, DIR /P, etc.).
  8776.  
  8777.               4DOS never attempts to manipulate your video hardware in order
  8778.               to set the number of rows actually displayed on the screen
  8779.               (the "video mode");  to do so, you must use the software that
  8780.               came with your video board or other software tailored to your
  8781.               system.
  8782.  
  8783.               4DOS does not handle display scrolling at the command prompt.
  8784.               If you put the screen in 43-line or 50-line mode and find that
  8785.               it still scrolls at the 25th line, your ANSI driver is
  8786.               probably not properly supporting your extended screen length.
  8787.               This is not a bug in 4DOS.
  8788.  
  8789.               The video cursor shape that 4DOS uses is defined as a
  8790.               percentage of a character cell height.  You can set the height
  8791.               independently for insert and overstrike mode with the
  8792.               CursorIns and CursorOver directives in 4DOS.INI or with the
  8793.               SETDOS /S command.  If you don't use either, 4DOS sets the
  8794.               height to 10% of the character cell height for overstrike mode
  8795.               and 100% (a block cursor) for insert mode.
  8796.  
  8797.               If you have trouble with the cursor, use SETDOS /S to find the
  8798.               values that work for your system.  Some video boards may not
  8799.               give a "smooth" response to varying SETDOS /S values.  For
  8800.               example, a value of 20% may generate a very small cursor while
  8801.               a value of 30% may generate a half-height cursor.  4DOS can't
  8802.               do anything about this behavior, so you will have to
  8803.               experiment to find the cursor values that you want to use.
  8804.  
  8805.               If the cursor disappears and you can't fix it with SETDOS /S,
  8806.               you probably have a screen color problem.  The cursor is shown
  8807.               in the color of the underlying character cell.  If that cell
  8808.               has (for example) the color attribute of black on black, the
  8809.               cursor will be invisible.  If you are using an ANSI driver,
  8810.               you can fix this problem easily by clearing the screen to a
  8811.               known color with the CLS command.  If the cursor still doesn't
  8812.               reappear, you will have to determine what is setting your
  8813.               screen attributes to an invisible color.  For example, you
  8814.               might be using an ANSI driver that assumes a 25-line video
  8815.               mode on an EGA/VGA system running in 43-line or 50-line mode.
  8816.               This can cause the driver to set portions of the screen to an
  8817.               invisible color when the screen is cleared.
  8818.  
  8819.  
  8820.           ___________________________________________________________________
  8821.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  147
  8822.  
  8823.                        CHAPTER 7 / USING 4DOS WITH YOUR HARDWARE AND SOFTWARE
  8824.           ___________________________________________________________________
  8825.  
  8826.  
  8827.               If you are using an EGA or VGA adapter, we encourage you to
  8828.               try UltraVision from Personics Corp.  It gives you excellent
  8829.               control over your video system, includes a wide variety of
  8830.               text-mode screen fonts, has its own ANSI driver, and works
  8831.               superbly with 4DOS.  We use it and wouldn't be without it.  A
  8832.               special version for laptop and notebook computers dramatically
  8833.               improves the readability of their smaller displays.
  8834.  
  8835.               Most versions of DOS include a copy of ANSI.SYS, a device
  8836.               driver that is normally installed with a DEVICE= line in your
  8837.               CONFIG.SYS file.  There are a number of more powerful and
  8838.               faster versions available as public-domain, shareware, and
  8839.               retail products.  We use PC Magazine's free utility ANSI.COM
  8840.               because it can be enabled, disabled, loaded, and unloaded
  8841.               without rebooting, and because it is small and fast and works
  8842.               well inside windows of multitasking systems.  It is available
  8843.               on most bulletin boards and online systems.  Another excellent
  8844.               choice is ANSI-UV.SYS which is included with UltraVision.
  8845.  
  8846.               4DOS normally detects automatically whether an ANSI driver is
  8847.               installed.  If you have an ANSI driver installed and 4DOS
  8848.               doesn't recognize it, try the command SETDOS /A1 which forces
  8849.               4DOS to use ANSI commands.  Use SETDOS /A2 to tell 4DOS you do
  8850.               not have an ANSI driver installed.  These options can also be
  8851.               set with the ANSI directive in 4DOS.INI.
  8852.  
  8853.               4DOS's bright background support, enabled with the BrightBG
  8854.               directive in 4DOS.INI (see page 129) is compatible with most
  8855.               EGA and VGA video boards.  However bright backgrounds may
  8856.               cause screen "flashes" at the prompt, or otherwise work
  8857.               improperly, with some unusual or non-standard video systems.
  8858.               If you experience such problems after setting BrightBG, try
  8859.               removing the BrightBG directive from your 4DOS.INI file
  8860.               entirely.
  8861.  
  8862.  
  8863.               Hard Drives and Floppy Disks
  8864.  
  8865.               4DOS uses your disks for a wide variety of purposes, and many
  8866.               4DOS commands are designed to help you create, move, delete,
  8867.               view, and otherwise manage disk files.  4DOS never tries to
  8868.               manipulate the structure of your hard disk directly.  It never
  8869.               modifies the FAT, root directory, or other system areas of the
  8870.               disk directly, and it doesn't read or write data on your disk
  8871.               itself.  It always calls on DOS to perform these actions, just
  8872.               like most application programs do.  As a result, 4DOS is
  8873.               compatible with all disk sizes, formats, and structures that
  8874.               your DOS version supports.
  8875.  
  8876.  
  8877.           ___________________________________________________________________
  8878.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  148
  8879.  
  8880.                        CHAPTER 7 / USING 4DOS WITH YOUR HARDWARE AND SOFTWARE
  8881.           ___________________________________________________________________
  8882.  
  8883.  
  8884.               The most common question that we're asked about 4DOS and disks
  8885.               is whether 4DOS will handle a hard disk larger than 32
  8886.               Megabytes.  The answer depends on how your system is
  8887.               configured.  Early versions of DOS do not support hard disks
  8888.               over 32 Megabytes unless a disk partitioning driver like
  8889.               SpeedStor, Vfeature Deluxe, or Disk Manager is used.  Later
  8890.               versions of DOS support large hard disks directly, without a
  8891.               partitioning driver.  If your system supports large hard
  8892.               disks, either directly through DOS or with a partitioning
  8893.               driver, 4DOS will support them also.  If your system doesn't
  8894.               support large hard disks, neither will 4DOS.
  8895.  
  8896.               4DOS will generally access your disk very quickly, but the
  8897.               speed depends on what you are trying to do.  If you find that
  8898.               4DOS is slower at performing a particular function than you
  8899.               are used to, you may have asked it to do more than you ask of
  8900.               traditional DOS commands.  In particular, if you use file
  8901.               descriptions, remember that 4DOS has to access the description
  8902.               file as well as the actual files that you are manipulating.
  8903.  
  8904.               Some users notice that the common commands DEL and DIR appear
  8905.               slower with 4DOS under certain circumstances.  With DEL, this
  8906.               slowdown may be because 4DOS uses a newer method of file
  8907.               deletion instead of an older method that is no longer
  8908.               recommended (but commonly used).  The new method is necessary
  8909.               to enable 4DOS to display the names of the files you are
  8910.               deleting, and to support 4DOS's "extended wildcards" (see page
  8911.               71).  You can force 4DOS to use the older method with DEL's /Q
  8912.               option as long as you don't use extended wildcards.
  8913.  
  8914.               For DIR, any perceived speed decrease is because of 4DOS's
  8915.               directory sorting.  4DOS must read all filenames before it can
  8916.               display any of them.  The sort itself is quite fast, but DOS
  8917.               is relatively slow at retrieving the entire list of file names
  8918.               and passing them on to 4DOS.  Once the 4DOS DIR display
  8919.               starts, it should go as fast as or faster than the traditional
  8920.               DIR display.
  8921.  
  8922.               Whenever 4DOS is interrupted by a Ctrl-C or Ctrl-Break, it
  8923.               performs a "disk reset" to clear out DOS disk buffers and
  8924.               reset internal DOS disk parameters.  This helps ensure that
  8925.               modified data has been written to disk even though the
  8926.               operation was interrupted.  A disk reset is also performed
  8927.               before a REBOOT command.  If you have trouble with recognition
  8928.               of floppy disk changes, with CD-ROM drivers, or with network
  8929.               disk access, you can try forcing 4DOS to perform a disk reset
  8930.               after file processing commands, and before a DIR.  To do so
  8931.               use a DiskReset = Yes directive in 4DOS.INI (see page 139).
  8932.  
  8933.  
  8934.           ___________________________________________________________________
  8935.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  149
  8936.  
  8937.                        CHAPTER 7 / USING 4DOS WITH YOUR HARDWARE AND SOFTWARE
  8938.           ___________________________________________________________________
  8939.  
  8940.  
  8941.               Such problems are very rare and normally DiskReset = Yes is
  8942.               not necessary.
  8943.  
  8944.  
  8945.               Laptop and Notebook Computers
  8946.  
  8947.               4DOS makes a great addition to any laptop or notebook
  8948.               computer, but some of these systems have unusual
  8949.               characteristics which you must consider when you install 4DOS
  8950.               or make any change to your CONFIG.SYS file.
  8951.  
  8952.               Many of these computers boot from a floppy drive or a hard
  8953.               disk just like a desktop computer.  On these machines, you can
  8954.               generally install 4DOS just as you would on any other
  8955.               computer.  However, some laptop and notebook computers,
  8956.               including many Tandy laptops, boot from ROM ("Read Only
  8957.               Memory" chips inside the computer).  You need to take some
  8958.               precautions with these machines.
  8959.  
  8960.               First, systems which boot from ROM often can be configured to
  8961.               use either the ROM boot feature or a standard floppy or hard
  8962.               drive boot up.  The following comments only apply when you use
  8963.               the ROM boot feature.
  8964.  
  8965.             ! If your system allows you to boot from ROM but load CONFIG.SYS
  8966.               and AUTOEXEC.BAT from a hard disk or floppy, you need to be
  8967.               cautious.  If you make a mistake in a hard-disk based
  8968.               CONFIG.SYS that keeps your system from booting, there may be
  8969.               no way to tell the ROM boot program to ignore the bad
  8970.               CONFIG.SYS file.  You may have to take drastic measures like
  8971.               opening the case and disconnecting the hard drive to get the
  8972.               system to ignore your mistaken CONFIG.SYS and boot properly.
  8973.  
  8974.               If you have a system that boots from ROM and reads CONFIG.SYS
  8975.               from the hard disk, we strongly recommend that you change the
  8976.               configuration to boot from the hard disk or a floppy before
  8977.               you make any change to your CONFIG.SYS file, whether it is
  8978.               related to 4DOS or not.  This will allow you to boot from a
  8979.               boot-up floppy disk if you make an error in the CONFIG.SYS on
  8980.               your hard drive.  Once you are satisfied that everything is
  8981.               working properly, you can switch back to ROM bootup.
  8982.  
  8983.               The second, and related, issue with systems that boot from ROM
  8984.               is that they may consider the ROM to be a disk drive of sorts.
  8985.               A system with drive C as the hard disk may view the ROM as
  8986.               drive D.  When you boot from ROM, the ROM drive is the current
  8987.               drive, and that is where 4DOS will look for the 4START and
  8988.               AUTOEXEC.BAT files.  But they will be on your hard drive or
  8989.  
  8990.  
  8991.           ___________________________________________________________________
  8992.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  150
  8993.  
  8994.                        CHAPTER 7 / USING 4DOS WITH YOUR HARDWARE AND SOFTWARE
  8995.           ___________________________________________________________________
  8996.  
  8997.  
  8998.               floppy diskette, and 4DOS won't be able to find them.  (This
  8999.               doesn't happen with COMMAND.COM on these systems because the
  9000.               manufacturer has modified it to get around the problem.)
  9001.  
  9002.               If you run into this problem, you can fix it easily with some
  9003.               changes to your CONFIG.SYS and 4DOS.INI files.  First, modify
  9004.               the SHELL= line in CONFIG.SYS so that it tells 4DOS where to
  9005.               find 4DOS.INI.  You can do this by placing the full path to
  9006.               4DOS.INI on the line, like this (see page 111 for more
  9007.               details):
  9008.  
  9009.                    shell=c:\4dos\4dos.com @c:\4dos.ini /p
  9010.  
  9011.               (change the drive and path shown if 4DOS.COM is not in the
  9012.               directory C:\4DOS on your system).  This tells 4DOS to look
  9013.               for 4DOS.INI on drive C, even though the boot drive might be
  9014.               (for example) drive D.  Then add two lines to the 4DOS.INI
  9015.               file (see page 125 for details on these directives):
  9016.  
  9017.                    4StartPath=c:\
  9018.                    AutoExecPath=c:\
  9019.  
  9020.               These tell 4DOS to look for 4START and AUTOEXEC.BAT in the
  9021.               root directory of drive C, even though the boot drive may be
  9022.               different.
  9023.  
  9024.               If you have a system like this, 4DOS may set the COMSPEC to
  9025.               the ROM drive.  You can avoid this by setting the COMSPEC
  9026.               yourself on the SHELL= line in CONFIG.SYS (see page 110).  For
  9027.               example, the SHELL= line above could be modified to read:
  9028.  
  9029.                    shell=c:\4dos\4dos.com c:\4dos @c:\4dos.ini /p
  9030.  
  9031.               The second "C:\4DOS" tells 4DOS to use this directory as the
  9032.               COMSPEC path.
  9033.  
  9034.               Finally, if you have a laptop or notebook computer with a
  9035.               color (CGA, EGA, or VGA) video board and a monochrome screen,
  9036.               you may need to use the HELP /M option,  the HelpOptions
  9037.               directive in 4DOS.INI, or run HELPCFG to adjust the HELP
  9038.               colors.
  9039.  
  9040.  
  9041.               Critical Errors
  9042.  
  9043.               A "critical" error is an error that gives you the "Abort,
  9044.               Retry, Fail" message.  With 4DOS running, this message appears
  9045.               as follows:
  9046.  
  9047.  
  9048.           ___________________________________________________________________
  9049.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  151
  9050.  
  9051.                        CHAPTER 7 / USING 4DOS WITH YOUR HARDWARE AND SOFTWARE
  9052.           ___________________________________________________________________
  9053.  
  9054.  
  9055.                    [Error message]
  9056.                    R(etry), I(gnore), F(ail), or A(bort)?
  9057.  
  9058.               The error message on the first line explains the error that
  9059.               has occurred, and the device on which it occurred.  The second
  9060.               line prompts for your choice of action (the Fail choice will
  9061.               not be displayed under DOS 2).
  9062.  
  9063.               A critical error usually indicates a hardware malfunction.
  9064.               The error may be that the device doesn't exist, there is no
  9065.               disk in the drive, the network has gone down, or a data error
  9066.               occurred.  In most cases you will choose R to retry the
  9067.               operation, or A to abort the operation.
  9068.  
  9069.             ! Choosing I(gnore) can be risky:  it will cause 4DOS to proceed
  9070.               as if the error had not occurred.  This can produce additional
  9071.               errors, and may lead the command which generated the original
  9072.               error to perform its functions improperly.
  9073.  
  9074.               F(ail) will tell 4DOS that the operation it was attempting has
  9075.               failed, which will generally produce another error message.
  9076.               For example, if you attempt to do a directory on drive A with
  9077.               no disk in the drive, and answer F to the resulting critical
  9078.               error, you will get an additional error message, "Invalid
  9079.               drive A".
  9080.  
  9081.               Many programs install their own critical error handlers.  If
  9082.               you get a critical error message within an application and the
  9083.               second line does not read as shown above, the message did not
  9084.               come from 4DOS.  Any problem in handling your response
  9085.               properly is due to the application, not to 4DOS.
  9086.  
  9087.               Choosing A(bort) within an application may abort the entire
  9088.               application and not just the operation being performed.  The
  9089.               specific action depends on which critical error handler is in
  9090.               use (4DOS's or the application's), and how the application's
  9091.               critical error handler (if any) is designed.
  9092.  
  9093.               If you are using 4DOS on a system that must run unattended
  9094.               (for example, a bulletin board), you can use the /F startup
  9095.               option in CONFIG.SYS or the CritFail directive in 4DOS.INI
  9096.               (see pages 110 and 138) to provide an automatic F(ail)
  9097.               response to all critical errors.  However, we do not recommend
  9098.               this on a normal system, because you will not have a chance to
  9099.               react to a critical error and correct the problem that caused
  9100.               it.
  9101.  
  9102.  
  9103.  
  9104.  
  9105.           ___________________________________________________________________
  9106.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  152
  9107.  
  9108.                        CHAPTER 7 / USING 4DOS WITH YOUR HARDWARE AND SOFTWARE
  9109.           ___________________________________________________________________
  9110.  
  9111.  
  9112.           Software
  9113.  
  9114.               You should find that 4DOS is compatible with all your PC
  9115.               software.  We have designed it carefully so that it uses only
  9116.               standard, documented methods to do its job.  It works properly
  9117.               with application software, utilities, networks, multitaskers
  9118.               and task switchers, memory-resident (TSR) programs, and system
  9119.               software like disk caches, memory managers, and device
  9120.               drivers.  We test 4DOS regularly with hundreds of popular
  9121.               software products in order to catch and correct compatibility
  9122.               problems before you encounter them.
  9123.  
  9124.               The following sections discuss using 4DOS with two major kinds
  9125.               of software:  multitasking and task switching programs, and
  9126.               networks.  For specific information about any individual
  9127.               software package, including the latest information about
  9128.               products mentioned here, see the APPNOTES.DOC file distributed
  9129.               with 4DOS.  It contains the latest information we have
  9130.               available when your copy of 4DOS was shipped.
  9131.  
  9132.               If you need to diagnose a problem that isn't covered below or
  9133.               in APPNOTES.DOC, see page 7.
  9134.  
  9135.  
  9136.               4DOS and DOS
  9137.  
  9138.               4DOS is compatible with all versions of MS-DOS and PC-DOS from
  9139.               2.0 through 5.0 and above, and with DR-DOS 3.4, 5.0, and
  9140.               above.  For MS-DOS and PC-DOS users, we recommend the use of
  9141.               DOS 3.1 or above.  Some specific considerations for DR-DOS
  9142.               users are discussed in APPNOTES.DOC.  MS-DOS users using the
  9143.               APPEND command may need to set up some aliases to invoke
  9144.               APPEND; see APPNOTES.DOC for details.
  9145.  
  9146.               If you use the FORMAT /S command from MS-DOS or PC-DOS,
  9147.               version 4.0 or above, FORMAT will copy the file pointed to by
  9148.               the COMSPEC environment variable (see page 116) and name it
  9149.               COMMAND.COM.  In most cases this means that 4DOS.COM will be
  9150.               copied to the floppy disk, but with the name COMMAND.COM.
  9151.               Such a disk should boot properly and start 4DOS, but its
  9152.               contents is sure to be confusing to others.  If you use FORMAT
  9153.               /S with MS-DOS or PC-DOS 4.0 or above, we recommend that you
  9154.               copy COMMAND.COM manually to the floppy disk (you can use an
  9155.               alias or batch file if you format bootable disks frequently),
  9156.               or rename the file that FORMAT copies to 4DOS.COM and place a
  9157.               proper CONFIG.SYS file for 4DOS on the floppy disk.
  9158.  
  9159.  
  9160.  
  9161.  
  9162.           ___________________________________________________________________
  9163.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  153
  9164.  
  9165.                        CHAPTER 7 / USING 4DOS WITH YOUR HARDWARE AND SOFTWARE
  9166.           ___________________________________________________________________
  9167.  
  9168.  
  9169.               Using 4DOS with Task Switchers and Multitaskers
  9170.  
  9171.               Task switchers are programs that allow you to switch quickly
  9172.               among multiple applications, with one application running at a
  9173.               time.  Multitaskers are more complex programs which run
  9174.               multiple applications at the same time, with one or more
  9175.               programs executing "in the background" while you work with
  9176.               another program on the screen.
  9177.  
  9178.               For convenience, in the text below we will refer to both
  9179.               multitaskers and task switchers as "multitaskers," and to each
  9180.               window or partition they use as a "window," even though some
  9181.               do not have windowed displays.
  9182.  
  9183.               4DOS works well as both the primary shell (loaded when your
  9184.               system boots) and the secondary shell (loaded in a window)
  9185.               with most multitaskers.
  9186.  
  9187.               Most multitaskers have a pre-configured "DOS" window.  In some
  9188.               programs, this window always runs COMMAND.COM.  Others run
  9189.               whatever program COMSPEC points to, which means they will run
  9190.               4DOS if you boot up with 4DOS.  We recommend that you always
  9191.               set up a 4DOS window explicitly, with the configuration you
  9192.               want, rather that relying on the multitasker's generic "DOS"
  9193.               window.
  9194.  
  9195.               Many multitaskers also run the command processor when you
  9196.               start certain kinds of windows, such as windows that run a
  9197.               .BAT file.  In general, this use of the command processor is
  9198.               transparent.  The multitasker will run 4DOS for you
  9199.               automatically when it needs to, and you won't need to do
  9200.               anything about it.
  9201.  
  9202.               If you find that your multitasker is running COMMAND.COM when
  9203.               you meant to run 4DOS, check the COMSPEC setting that is in
  9204.               effect when you start the multitasker.  You may also need to
  9205.               check the way a particular window is configured.
  9206.  
  9207.               When you set up a 4DOS window, be sure to specify the full
  9208.               path to 4DOS.COM, and any command-line options you want (see
  9209.               page 114 for information on command line options).  To set
  9210.               parameters (swapping, alias space, etc.) to be used by all
  9211.               4DOS secondary shells run by your multitasker, use the
  9212.               [Secondary] section in 4DOS.INI (see page 121).  To set these
  9213.               parameters separately for a specific window, create a copy of
  9214.               4DOS.INI just for that window and use the @d:\path\inifile
  9215.               option on your command line for the window to tell 4DOS where
  9216.               to find 4DOS.INI.  To change the configuration of a specific
  9217.  
  9218.  
  9219.           ___________________________________________________________________
  9220.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  154
  9221.  
  9222.                        CHAPTER 7 / USING 4DOS WITH YOUR HARDWARE AND SOFTWARE
  9223.           ___________________________________________________________________
  9224.  
  9225.  
  9226.               window without creating a separate copy of 4DOS.INI, use the
  9227.               //iniline option on your command line for the window (see
  9228.               example below).
  9229.  
  9230.               4DOS allows you to place a command to be executed as the last
  9231.               parameter on your 4DOS command line.  This command is executed
  9232.               before 4DOS displays its first prompt.  You can use this
  9233.               feature to run a batch file (or any other command) each time a
  9234.               4DOS window is started by your multitasker.  For example, if
  9235.               you are setting up 4DOS to run as a DOS application under
  9236.               Windows 3.0, your command line might look this:
  9237.  
  9238.                    c:\4dos\4dos.com //swapping=f:\ c:\winstart.btm
  9239.  
  9240.               This tells Windows to load 4DOS, includes a 4DOS.INI directive
  9241.               to tell 4DOS to swap to drive F, and passes 4DOS the command
  9242.               C:\WINSTART.BTM.  You can place commands in C:\WINSTART.BTM to
  9243.               be executed whenever such a window is started (for example, to
  9244.               change your PROMPT to show that you're in a window, or to load
  9245.               a TSR for just that window).  The command to be executed
  9246.               (C:\WINSTART.BTM in this example), must be the last thing on
  9247.               the 4DOS command line;  no 4DOS switches or options can be
  9248.               placed after it because anything after the command will be
  9249.               interpreted as parameters for the command.
  9250.  
  9251.               This command feature is similar to what's provided by the
  9252.               4START batch file, but 4START is executed every time 4DOS
  9253.               loads, whereas a file like WINSTART will be executed only when
  9254.               a 4DOS window is started from your multitasker.  A batch file
  9255.               started this way will be run after 4START.
  9256.  
  9257.               If you use KEYSTACK inside a window of a multitasker, and the
  9258.               KSTACK.COM program has been loaded before the multitasker, you
  9259.               may find that stacked keystrokes "bleed through" from one
  9260.               window to another.  You can solve this problem by loading
  9261.               KSTACK.COM in a startup batch file (see above) for each window
  9262.               where it is needed.  If KSTACK is loaded before the
  9263.               multitasker as well, include a /I on the command line when
  9264.               loading KSTACK inside the window.  If you don't, KSTACK will
  9265.               detect that it is already installed and will not install
  9266.               again.
  9267.  
  9268.  
  9269.               Multitasking and Disk Swapping
  9270.  
  9271.               When 4DOS is loaded as the primary shell, it acts as a
  9272.               "traffic cop" for copies of the transient portion of 4DOS
  9273.               swapped to disk.  Each secondary shell is assigned a unique
  9274.  
  9275.  
  9276.           ___________________________________________________________________
  9277.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  155
  9278.  
  9279.                        CHAPTER 7 / USING 4DOS WITH YOUR HARDWARE AND SOFTWARE
  9280.           ___________________________________________________________________
  9281.  
  9282.  
  9283.               shell number, which is used as the extension of its disk swap
  9284.               file (4DOSSWAP.001, 4DOSSWAP.002, etc.).  These shell numbers
  9285.               avoid file name conflicts between multiple copies of 4DOS
  9286.               running in different windows but creating swap files in the
  9287.               same disk directory.
  9288.  
  9289.               However, if 4DOS is not loaded before the multitasker, this
  9290.               capability will not be available.  In this case, the copy of
  9291.               4DOS in each window will use a swap file called 4DOSSWAP.000.
  9292.               To avoid a conflict in this situation, you must either use the
  9293.               UniqueSwapName directive in 4DOS.INI, or force every copy of
  9294.               4DOS to place its swap file in its own unique directory by
  9295.               using the "Swapping=d:\path" directive in 4DOS.INI.  If you
  9296.               don't follow this rule, your system will hang when you switch
  9297.               windows or when you exit from an application.
  9298.  
  9299.               This problem will occur only in those rare situations where
  9300.               4DOS is loaded within a window but is not loaded as your
  9301.               primary shell, and if 4DOS disk swapping is used in more than
  9302.               one window at a time.  The problem will not occur if 4DOS is
  9303.               loaded as the primary shell (the usual case), or if 4DOS can
  9304.               use EMS or XMS swapping for all simultaneous shells.  Note
  9305.               that since the default swapping option uses disk swapping if
  9306.               insufficient EMS or XMS memory is available, you can be
  9307.               invoking disk swapping in your multitasker's windows without
  9308.               specifically requesting it.
  9309.  
  9310.  
  9311.               4DOS and Microsoft Windows 3.0
  9312.  
  9313.               4DOS works well as both the primary shell, loaded before
  9314.               Windows 3, and as a secondary shell loaded inside any window.
  9315.               It works in any Windows mode (Real, Standard, or Enhanced).
  9316.               The previous general information about multitaskers applies to
  9317.               Windows as well.  You should read it before continuing with
  9318.               this section.
  9319.  
  9320.               To run 4DOS as a secondary shell from within Windows, you will
  9321.               need to create a Program Manager icon to run 4DOS.  The
  9322.               generic "DOS" icon supplied by Microsoft will only run
  9323.               COMMAND.COM.  You can set up a 4DOS icon from the Program
  9324.               Manager's File / New menu selection.
  9325.  
  9326.               First, create a new program item and set the command line to
  9327.               "C:\4DOS\4DOS.COM" (use the appropriate drive and path for
  9328.               your system).  As discussed above, you can put the name of a
  9329.               batch file at the end of the command line.
  9330.  
  9331.  
  9332.  
  9333.           ___________________________________________________________________
  9334.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  156
  9335.  
  9336.                        CHAPTER 7 / USING 4DOS WITH YOUR HARDWARE AND SOFTWARE
  9337.           ___________________________________________________________________
  9338.  
  9339.  
  9340.               To install a special 4DOS icon, use the Program Manager's File
  9341.               / Properties menu selection.  Click on the Change Icon button
  9342.               and type in the full path name of your new 4DOS icon file.  We
  9343.               supply two Windows icons with 4DOS:  4DOS.ICO for color
  9344.               displays, and 4DOSM.ICO for monochrome displays.  Of course,
  9345.               you can create your own with any icon editor.
  9346.  
  9347.               For more flexibility, you can use the Windows PIF editor to
  9348.               create a 4DOS.PIF file.  We have included a sample .PIF file
  9349.               on the distribution diskette.  You must edit this file and
  9350.               make it correspond to your system before you use it to run
  9351.               4DOS.
  9352.  
  9353.               If you run Windows in 386 Enhanced mode, 4DOS will work
  9354.               properly in either a full-screen or a windowed session.  The
  9355.               .PIF file determines the mode that 4DOS will start in.  If you
  9356.               don't use a .PIF file, 4DOS will always start in full-screen
  9357.               mode.
  9358.  
  9359.               Your batch files can determine whether they are running in a
  9360.               secondary shell under Windows, and the current Windows mode,
  9361.               with the 4DOS _WIN environment variable (see page 84).
  9362.  
  9363.               You can easily set up the Windows File Manager so that it will
  9364.               consider .BTM files to be "executable".  Open your WIN.INI
  9365.               file with any editor and find the section labeled
  9366.               "[extensions]".  Add the following line to the end of the
  9367.               section:
  9368.  
  9369.                    btm=c:\4dos\4dos.com /c ^.btm
  9370.  
  9371.               (adjust this to show the proper path for 4DOS.COM on your
  9372.               system).  It is not possible to execute .BTM files from the
  9373.               Program Manager by modifying the Programs= setting in WIN.INI;
  9374.               if you try to do so, the system will hang when you attempt to
  9375.               actually invoke a BTM file.
  9376.  
  9377.  
  9378.               4DOS and DESQview
  9379.  
  9380.               4DOS works well as both the primary shell loaded before
  9381.               DESQview, and as the secondary shell loaded inside any
  9382.               DESQview window.  The previous general information about
  9383.               multitaskers applies to DESQview as well.  You should read it
  9384.               before continuing with this section.
  9385.  
  9386.               To use 4DOS as a secondary shell with DESQview, you must add
  9387.               it to your DESQview "Open Window" menu.  To do this, select
  9388.  
  9389.  
  9390.           ___________________________________________________________________
  9391.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  157
  9392.  
  9393.                        CHAPTER 7 / USING 4DOS WITH YOUR HARDWARE AND SOFTWARE
  9394.           ___________________________________________________________________
  9395.  
  9396.  
  9397.               the Add a Program option, then press the "O" key (for Other
  9398.               Program).  Press Enter and you will get an Add a Program
  9399.               window.  You'll need to modify settings on the standard first
  9400.               screen, and on the second "advanced options" screen.  Set the
  9401.               Program Name to C:\4DOS\4DOS.COM (adjust the drive and path
  9402.               for your own computer).  Set the Parameters to whatever 4DOS
  9403.               startup options you want, but do not use /C or /P.  For other
  9404.               DESQview parameters, the defaults are workable with the
  9405.               following changes:
  9406.  
  9407.                    To run 4DOS in a full-screen window:
  9408.  
  9409.                          Writes Text Directly to Screen:    Y    (screen 1)
  9410.                          Virtualize Text / Graphics:        N    (screen 1)
  9411.                          Close on Exit to DOS:              Y    (screen 2)
  9412.                          Uses its Own Colors:               Y    (screen 2)
  9413.  
  9414.                    To run 4DOS in a window smaller than the full screen:
  9415.  
  9416.                          Writes Text Directly to Screen:    N    (screen 1)
  9417.                          Virtualize Text / Graphics:        Y/T  (screen 1)
  9418.                          Close on Exit to DOS:              Y    (screen 2)
  9419.                          Uses its Own Colors:               Y    (screen 2)
  9420.  
  9421.               4DOS is written to be "DESQview-aware", and will not "bleed
  9422.               through" to other windows when running full-screen commands
  9423.               such as HELP, LIST, or SELECT.
  9424.  
  9425.               If you use 4DOS commands that work with an ANSI driver (CLS,
  9426.               COLOR, and the COLORDIR environment variable), you will need
  9427.               to load the ANSI driver in your 4DOS window.  Drivers like PC
  9428.               Magazine's ANSI.COM may work in full-screen windows, but we've
  9429.               found that the only ANSI driver which works properly in a
  9430.               window smaller than the full screen is Quarterdeck's
  9431.               DVANSI.COM.
  9432.  
  9433.               You can set up a startup batch file to load your ANSI driver
  9434.               or take other actions when a DESQview 4DOS window is opened,
  9435.               as discussed in the general section on multitaskers above.
  9436.               Just place the batch file name (with drive and path if
  9437.               necessary) as the last thing on the Parameters line.
  9438.  
  9439.               You should normally exit a DESQview 4DOS window with the EXIT
  9440.               command, rather than with the Close option on DESQview's main
  9441.               menu.  If you do use the Close option while at the 4DOS
  9442.               prompt, 4DOS will be notified of your action and will clean up
  9443.               its resources (for example, the shell number and disk swap
  9444.               file in use in that window).  However this notification has a
  9445.  
  9446.  
  9447.           ___________________________________________________________________
  9448.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  158
  9449.  
  9450.                        CHAPTER 7 / USING 4DOS WITH YOUR HARDWARE AND SOFTWARE
  9451.           ___________________________________________________________________
  9452.  
  9453.  
  9454.               side-effect:  it disables the Quit option on the DESQview main
  9455.               menu (this is a feature of DESQview).  To disable the
  9456.               notification and reenable the Quit option, you can use a
  9457.               DVCleanup = No directive in 4DOS.INI (see page 139).  If you
  9458.               do so, be sure to exit 4DOS windows with the EXIT command to
  9459.               avoid leaving stray swap files on your disk or inadvertently
  9460.               using up 4DOS shell numbers.
  9461.  
  9462.               DESQview will work properly with the UMBLoad and
  9463.               UMBEnvironment directives set to Yes for the primary shell in
  9464.               4DOS.INI, but may not work properly if these directives are
  9465.               also active in secondary shells.  If you have trouble with
  9466.               secondary shells and are using either of these directives, try
  9467.               placing the following lines in the [Secondary] section of
  9468.               4DOS.INI:
  9469.  
  9470.                    UMBLoad = No
  9471.                    UMBEnvironment = No
  9472.  
  9473.               If you want to use DESQview's DOS Services program, check
  9474.               APPNOTES.DOC for the details on how to set it up for use with
  9475.               4DOS.
  9476.  
  9477.  
  9478.               Using 4DOS on a Network
  9479.  
  9480.               4DOS works well with DOS-compatible networks.  This section
  9481.               will give you some tips on using 4DOS properly on a network,
  9482.               and on the locations to use for 4DOS files on a network.
  9483.  
  9484.               In general, you'll find that you can load and run your network
  9485.               software normally under 4DOS.  Network drives will be
  9486.               accessible as normal drives once the network is loaded, and
  9487.               files on the network will be accessible just as if they were
  9488.               on a local hard disk.
  9489.  
  9490.               Some networks support file and directory names beginning with
  9491.               a double backslash, or with a server name followed by a colon,
  9492.               to identify files by their location on the network.  4DOS
  9493.               detects such names and passes them through to the network
  9494.               unaltered, allowing the network software to process them
  9495.               properly.
  9496.  
  9497.               In rare situations, you may have trouble loading network
  9498.               software under 4DOS.  To the best of our knowledge, all DOS-
  9499.               compatible networks do work with 4DOS.  If yours doesn't, our
  9500.               experience suggests that the most common cause is a network
  9501.               bug, an old version of your network software, or a conflict in
  9502.  
  9503.  
  9504.           ___________________________________________________________________
  9505.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  159
  9506.  
  9507.                        CHAPTER 7 / USING 4DOS WITH YOUR HARDWARE AND SOFTWARE
  9508.           ___________________________________________________________________
  9509.  
  9510.  
  9511.               the way 4DOS and your network are configured.  Most bugs have
  9512.               now been corrected by network vendors, and should not appear
  9513.               on your system.  If you have any questions about compatibility
  9514.               with your particular network, first check for a listing in
  9515.               APPNOTES.DOC; then of course feel free to contact our
  9516.               technical support department for assistance.
  9517.  
  9518.               If you need to boot a diskless workstation from a network
  9519.               drive, you must have the network drive accessible at boot
  9520.               time.  If this condition is satisfied (so 4DOS can find its
  9521.               files on the network drives), the normal approach can be used
  9522.               to start 4DOS from the network.
  9523.  
  9524.               Some networks with large server disk drives (256 MB or more)
  9525.               may report values that are too small if the FREEcommand and
  9526.               the %@DISKFREE, %@DISKTOTAL, and %@DISKUSED variable functions
  9527.               are used for the server drive.  If this occurs, it is because
  9528.               the network software does not provide a way to return larger
  9529.               values to 4DOS.
  9530.  
  9531.             ! When you use 4DOS on a network, pay attention to where files
  9532.               are stored in order to ensure that two 4DOS users do not
  9533.               attempt to access the same 4DOS file at the same time.  You
  9534.               will need to pay particular attention to disk swapping and
  9535.               pipes.
  9536.  
  9537.               If 4DOS uses disk swapping (either because of an explicit
  9538.               directive in 4DOS.INI or because default swapping is used and
  9539.               no EMS or XMS memory is available), you should be sure that
  9540.               two users don't use the same directory simultaneously for
  9541.               their disk swap files.  If they do, the filenames
  9542.               (4DOSSWAP.000, 4DOSSWAP.001, etc.) will conflict and each user
  9543.               will write over the other's files, possibly causing one or
  9544.               both systems to hang.  To take care of this, use the Swapping
  9545.               directive in 4DOS.INI to assign each user's swap files to a
  9546.               different directory on the network drive.
  9547.  
  9548.               Pipes are a method of passing information from one program to
  9549.               another, and are invoked with the pipe symbol [|] on the
  9550.               command line (see page 66).  Pipes work by taking the output
  9551.               from one program, storing it in a temporary file, then telling
  9552.               a second program to obtain its input from that file.  The
  9553.               temporary files, with names like P1.$00 and P2.$00, are placed
  9554.               by default in the root directory of the boot drive, but can be
  9555.               placed on a different drive and directory by setting the TEMP
  9556.               or TEMP4DOS environment variable (see page 116).
  9557.  
  9558.  
  9559.  
  9560.  
  9561.           ___________________________________________________________________
  9562.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  160
  9563.  
  9564.                        CHAPTER 7 / USING 4DOS WITH YOUR HARDWARE AND SOFTWARE
  9565.           ___________________________________________________________________
  9566.  
  9567.  
  9568.               The same cautions given for disk swapping must be followed for
  9569.               pipe temporary files; that is, you must ensure that each
  9570.               user's temporary pipe files go to a separate directory.  To do
  9571.               this, just be sure that each network user running 4DOS has
  9572.               TEMP or TEMP4DOS set to a unique directory.  If you boot 4DOS
  9573.               from a local hard disk, the pipe temporary files will go to
  9574.               that disk and the environment variable setting will not be
  9575.               necessary.
  9576.  
  9577.  
  9578.           Solving Software Compatibility Problems
  9579.  
  9580.               Any DOS program running on your computer can potentially
  9581.               interact with any other program running at the same time.  Of
  9582.               course, most program interactions are ones you want: your
  9583.               print spooler intercepts printer output and saves it to print
  9584.               later, or your disk cache intercepts disk requests and speeds
  9585.               them up by retrieving data from memory.
  9586.  
  9587.               If you've used the PC for any length of time, however, you'll
  9588.               know that you can also get interactions you don't want.  If
  9589.               you load just the wrong combination of TSRs and device
  9590.               drivers, your system may slow to a crawl.  Perhaps you can't
  9591.               load your favorite Personal Information Manager with Windows
  9592.               running.  And so on.
  9593.  
  9594.               As publishers of a product that replaces part of the operating
  9595.               system, we're very familiar with these issues -- not because
  9596.               4DOS is more likely to cause problems, but because it
  9597.               sometimes gets blamed first when a problem appears.  Our
  9598.               technical support department has developed a set of reliable
  9599.               techniques for finding out what's causing an apparent
  9600.               compatibility problem with 4DOS and other software.
  9601.  
  9602.               We are presenting these techniques here as a series of things
  9603.               to try when there seems to be a compatibility problem.  Some
  9604.               may not make sense for the particular problem you're
  9605.               investigating.  Others may not yield useful results.  But as a
  9606.               group, they'll help you resolve many of the common software
  9607.               interactions that do appear, whether with 4DOS or anything
  9608.               else.
  9609.  
  9610.               Some of our suggestions help you figure out what's going on,
  9611.               but aren't intended to help you fix it.  For example, when we
  9612.               suggest that you remove all your TSRs to look for the problem,
  9613.               we aren't suggesting that as a permanent solution, but only as
  9614.               a diagnostic test.  Before you get started, be sure to check
  9615.  
  9616.  
  9617.  
  9618.           ___________________________________________________________________
  9619.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  161
  9620.  
  9621.                        CHAPTER 7 / USING 4DOS WITH YOUR HARDWARE AND SOFTWARE
  9622.           ___________________________________________________________________
  9623.  
  9624.  
  9625.               APPNOTES.DOC to see if we've already solved the problem you're
  9626.               facing.
  9627.  
  9628.               The first thing to consider is whether the particular
  9629.               combination of software that's not working used to work
  9630.               together.  If so, think carefully about what you have changed
  9631.               and see if reversing the change solves the problem.  If it
  9632.               does, then you can narrow your search, using the following
  9633.               techniques to find out what it is about that specific change
  9634.               that is causing the problem.
  9635.  
  9636.               Second, make sure that your problem can be reproduced
  9637.               relatively easily, and make sure you know exactly what
  9638.               sequence of commands or other steps reproduces it.  Most
  9639.               interactions are very easy to reproduce, but if you think
  9640.               there's an interaction and it occurs once every 10 days, it's
  9641.               going to be difficult to know when you have fixed it.  Also,
  9642.               the process of carefully documenting how to reproduce a
  9643.               problem often helps you realize what the problem is without
  9644.               further effort.
  9645.  
  9646.               Third, if you have a problem with a specific application
  9647.               hanging or working improperly, try cleaning up the
  9648.               "atmosphere" in which that program runs.  This is the single
  9649.               most useful tool we know for finding compatibility problems.
  9650.               By "cleaning up the atmosphere" we mean all of the following,
  9651.               and any other similar things you may be able to think of about
  9652.               your particular system after reading our suggestions below:
  9653.  
  9654.                    Check the length of your PATH variable.  4DOS lets you
  9655.                    make it longer than the standard limit of 123 characters.
  9656.                    Some programs can't handle long PATHs and may behave
  9657.                    strangely.  If your PATH is over the normal limit, reduce
  9658.                    its size using the PATH or ESET command and see if the
  9659.                    application starts working.  If so, use a batch file or
  9660.                    alias to set up an alternate path for running that one
  9661.                    program, for example:
  9662.  
  9663.                         setlocal
  9664.                         path d:\myprog
  9665.                         d:\myprog\myprog.exe
  9666.                         endlocal
  9667.  
  9668.                    The SETLOCAL / ENDLOCAL pair saves and restores the
  9669.                    environment;  when you're done, the old PATH will be
  9670.                    restored automatically (see page 309).
  9671.  
  9672.  
  9673.  
  9674.  
  9675.           ___________________________________________________________________
  9676.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  162
  9677.  
  9678.                        CHAPTER 7 / USING 4DOS WITH YOUR HARDWARE AND SOFTWARE
  9679.           ___________________________________________________________________
  9680.  
  9681.  
  9682.                    Next, check how much environment space is in use in your
  9683.                    system.  The 4DOS MEMORY command reports the total
  9684.                    environment space and the amount free; a simple
  9685.                    subtraction tells you how much is in use.  Some programs
  9686.                    use outdated techniques and simply don't work right if
  9687.                    there's a lot of information in the environment (these
  9688.                    programs don't usually care how big the total environment
  9689.                    space is, only how much of it is actually in use).  In
  9690.                    most cases, these problems show up when the amount of
  9691.                    space in use gets up to around 1K (1024) bytes or so, but
  9692.                    they can occur at any point. To test for this, use the
  9693.                    following simple batch file:
  9694.  
  9695.                         setlocal
  9696.                         unset var1 var2 var3 ...
  9697.                         [command to run the program in question]
  9698.                         endlocal
  9699.  
  9700.                    where VAR1, VAR2, etc. are variables you can remove from
  9701.                    the environment to decrease the space in use before
  9702.                    running the program.  If reducing the environment space
  9703.                    in use makes things work, contact the program's
  9704.                    manufacturer and report the problem.  You have found a
  9705.                    legitimate bug.  DOS allows an environment of up to 32K
  9706.                    and all programs should be able to work with an
  9707.                    environment that large.  Until the manufacturer fixes the
  9708.                    bug, use the batch file above as a workaround.
  9709.  
  9710.                    Next, look for a multi-program interaction.  Remove all
  9711.                    the device drivers and TSRs you possibly can and still
  9712.                    have enough software present to demonstrate the problem.
  9713.                    For example, you can't look for a network problem if you
  9714.                    don't load the network, but you probably can check it
  9715.                    without your disk cache running.  When you do this, and
  9716.                    any time you modify your boot configuration, be sure you
  9717.                    have a bootable floppy disk handy.
  9718.  
  9719.                    If you run a partitioning disk driver like SpeedStor,
  9720.                    Vfeature, or Disk Manager, you probably can't remove it
  9721.                    for diagnostic purposes without temporarily losing access
  9722.                    to some or all of your hard disk.  The same may be true
  9723.                    of disk compression programs like Stacker, depending on
  9724.                    the mode in which they are installed.  Most other device
  9725.                    drivers and TSRs can be removed without causing trouble.
  9726.                    Check your system and software manuals if you are unsure
  9727.                    of which programs can safely be removed.
  9728.  
  9729.  
  9730.  
  9731.  
  9732.           ___________________________________________________________________
  9733.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  163
  9734.  
  9735.                        CHAPTER 7 / USING 4DOS WITH YOUR HARDWARE AND SOFTWARE
  9736.           ___________________________________________________________________
  9737.  
  9738.  
  9739.                    Once you know what you can take out, don't skimp or guess
  9740.                    where the interaction might be.  Take out everything you
  9741.                    possibly can from CONFIG.SYS, 4START, and AUTOEXEC.BAT
  9742.                    that loads or accesses another program .  In CONFIG.SYS,
  9743.                    remove all possible DEVICE and INSTALL statements.  In
  9744.                    AUTOEXEC.BAT, remove all the lines you can that load
  9745.                    memory-resident programs (and remember that some DOS
  9746.                    utilities, like MODE, can be memory-resident).  Of
  9747.                    course, save copies of your configuration files before
  9748.                    you delete anything.  Better yet, use the REM command to
  9749.                    remove lines temporarily without deleting them.  REM can
  9750.                    be used on any line in AUTOEXEC.BAT, in 4START, and in
  9751.                    CONFIG.SYS if you are running DOS 4.0 or above.  In
  9752.                    earlier versions, REM will work in CONFIG.SYS but will
  9753.                    also generate a harmless "unrecognized command" error
  9754.                    message during bootup.  If you want to remove everything
  9755.                    in AUTOEXEC.BAT you can simply rename it to any other
  9756.                    name, and rename it back when you are done testing.
  9757.  
  9758.                    Clean out your configuration files all at once, not one
  9759.                    line at a time.  If that solves the problem, you're on
  9760.                    the right track, and you can put the lines back one at a
  9761.                    time until you find the culprit.  If it doesn't solve the
  9762.                    problem, you won't waste time removing lines one by one.
  9763.  
  9764.                    If you do find a suspect program, first try booting your
  9765.                    system with COMMAND.COM, without changing anything else
  9766.                    about your configuration.  If the problem remains, then
  9767.                    it's not related to an interaction with 4DOS.
  9768.  
  9769.                    If the problem isn't there under COMMAND.COM, try
  9770.                    fiddling with the program's configuration. If you were
  9771.                    loading it high, try loading it low.  If you can change
  9772.                    the way it uses memory, try doing so.  If it's a driver
  9773.                    that's used by other programs (like your mouse driver)
  9774.                    and is quite old, consider obtaining an update from the
  9775.                    manufacturer. All of these techniques will help you
  9776.                    narrow down what it is about the program that's causing a
  9777.                    problem.  Once you have done that, you may have a simple
  9778.                    workaround.  If not, contact our technical support crew
  9779.                    and we'll try to verify the problem, then resolve it with
  9780.                    the manufacturer of the other software.
  9781.  
  9782.                    Rarely, some problems can be resolved by modifying the
  9783.                    order in which you load drivers and TSRs.  If you've
  9784.                    found a problem with a particular driver or TSR, try
  9785.                    loading it earlier or later than you were and see if the
  9786.                    problem goes away.
  9787.  
  9788.  
  9789.           ___________________________________________________________________
  9790.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  164
  9791.  
  9792.                        CHAPTER 7 / USING 4DOS WITH YOUR HARDWARE AND SOFTWARE
  9793.           ___________________________________________________________________
  9794.  
  9795.  
  9796.               Next, try modifying the atmosphere in another way:  change the
  9797.               way 4DOS is configured.  In particular, try changing the 4DOS
  9798.               swapping type using the Swapping directive in 4DOS.INI (see
  9799.               page 126).  This technique is especially appropriate if the
  9800.               system hangs every time you exit a particular application.  If
  9801.               that solves the problem, there's probably a memory conflict.
  9802.               Another program is trying to use the same memory space 4DOS
  9803.               uses for swapping.  See if you can control the other program's
  9804.               memory usage.
  9805.  
  9806.               If you can configure 4DOS and the other program to work
  9807.               together, you're all set.  If they work together only in a
  9808.               useless combination (for example, with 4DOS swapping turned
  9809.               off), contact us.  We'll try to figure out what the other
  9810.               program is doing to damage 4DOS's swap space and get the
  9811.               manufacturer to take care of the problem.
  9812.  
  9813.               You can also change the UMB-related configuration settings
  9814.               (UMBLoad and UMBEnvironment) to help diagnose compatibility
  9815.               problems.  Problems with these directives are rare, but if
  9816.               you're at an impasse, try setting both of these values to "No"
  9817.               in 4DOS.INI.
  9818.  
  9819.               Some of the advanced directives in 4DOS.INI (see page 138) may
  9820.               help solve very rare configuration problems, but unless you
  9821.               are an experienced DOS user and understand the side effects of
  9822.               each directive, they should be used only as diagnostic tools,
  9823.               and not as a workaround or fix. Any of the following can be
  9824.               tried:
  9825.  
  9826.                    Inherit = No
  9827.                    LineInput = Yes      (or SETDOS /L1)
  9828.                    Reduce = No
  9829.                    StackSize = nnnn     (increase value to 4096 or more)
  9830.  
  9831.               If you've tried all these techniques and haven't found the
  9832.               problem, contact our technical support department (see page
  9833.               7).  We have more tricks up our sleeve, and a very high
  9834.               success rate at resolving software interactions.
  9835.  
  9836.  
  9837.  
  9838.  
  9839.  
  9840.  
  9841.  
  9842.  
  9843.  
  9844.  
  9845.  
  9846.           ___________________________________________________________________
  9847.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  165
  9848.  
  9849.                                           CHAPTER 8 / COMMAND REFERENCE GUIDE
  9850.           ___________________________________________________________________
  9851.  
  9852.  
  9853.  
  9854.           CHAPTER 8 / COMMAND REFERENCE GUIDE
  9855.  
  9856.  
  9857.           The following pages are a complete guide and reference to the 4DOS
  9858.           commands that are available from the command line, in aliases, and
  9859.           in batch files.  Nearly all of these commands are internal 4DOS
  9860.           commands, which means that 4DOS performs the activity you have
  9861.           requested without running another program.  External commands
  9862.           require loading and running a separate program, either an
  9863.           executable (.EXE or .COM) program or a batch (.BTM or .BAT)
  9864.           program.  DOS is shipped with a number of external utility programs
  9865.           (such as FORMAT and DISKCOPY), and any program or application you
  9866.           install on your system becomes a new external command.
  9867.  
  9868.           The advantage of internal commands is that they run almost
  9869.           instantly.  When you give 4DOS an internal command, it interprets
  9870.           the command line and carries out the necessary activities without
  9871.           having to look for, load, and run another program.
  9872.  
  9873.           The advantage of external commands is that they can be large,
  9874.           varied, and complex without taking space inside the system command
  9875.           processor.  External commands can also be renamed or replaced
  9876.           easily.  If you want to rename the external DOS command XCOPY to
  9877.           MYCOPY, for example, all you need to do is find the file called
  9878.           XCOPY.EXE on your DOS disk or directory and change its name to
  9879.           MYCOPY.EXE.  If you want to replace XCOPY with a more efficient
  9880.           program, you can do so.  4DOS adds this flexibility to internal
  9881.           commands.  You can rename or replace any internal command by using
  9882.           an ALIAS, and you can enable or disable internal commands whenever
  9883.           you wish.
  9884.  
  9885.  
  9886.           4DOS Commands
  9887.  
  9888.               4DOS has over 80 internal commands, many more than any version
  9889.               of DOS.  4DOS neither replaces nor interferes with external
  9890.               DOS commands like ASSIGN, BACKUP, CHKDSK, DISKCOPY, SUBST, or
  9891.               XCOPY.  Once 4DOS is installed, you can continue to use those
  9892.               utilities like you always have.  Also, 4DOS has been designed
  9893.               so that it is compatible with virtually all traditional
  9894.               internal commands, even though it enhances many of those
  9895.               commands with additional options and capabilities.  Once you
  9896.               have installed 4DOS, you can continue using the commands that
  9897.               you already know and get the same results.
  9898.  
  9899.               A few of the 4DOS commands are the same as traditional
  9900.               commands, some are enhanced with new features, and many are
  9901.  
  9902.  
  9903.           ___________________________________________________________________
  9904.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  166
  9905.  
  9906.                                           CHAPTER 8 / COMMAND REFERENCE GUIDE
  9907.           ___________________________________________________________________
  9908.  
  9909.  
  9910.               unique to 4DOS.  The best way to learn the 4DOS commands is to
  9911.               use them and experiment with them.  The following lists
  9912.               categorize the available commands by topic and will help you
  9913.               find the ones that you need.  Most of this chapter is an
  9914.               alphabetic list of the commands and how to use each one.  We
  9915.               urge you to browse through this chapter occasionally and look
  9916.               for commands that might help simplify your computing life.
  9917.  
  9918.               In the following summary lists, commands that are unique to
  9919.               4DOS are marked with a  number sign [#].  Those which are
  9920.               enhanced traditional commands are marked with an asterisk [*].
  9921.               And those which are identical to traditional commands have no
  9922.               marks at all.
  9923.  
  9924.               System Configuration Commands:
  9925.  
  9926.                  BREAK          CHCP           CTTY           DATE
  9927.                  FREE #         LH / LOADHIGH  MEMORY #       PROMPT *
  9928.                  REBOOT #       SETDOS #       SWAPPING #     TIME
  9929.                  VER            VERIFY         VOL *
  9930.  
  9931.               File and directory management:
  9932.  
  9933.                  ATTRIB *       COPY *         DEL / ERASE *  DESCRIBE #
  9934.                  MOVE #         REN / RENAME * TRUENAME #
  9935.  
  9936.               Subdirectory management:
  9937.  
  9938.                  CD / CHDIR *   CDD #          DIR *          DIRS #
  9939.                  MD / MKDIR *   POPD #         PUSHD #        RD / RMDIR *
  9940.  
  9941.               Commands normally used in batch files and aliases (many are
  9942.               also useful at the command line):
  9943.  
  9944.                  ALIAS #        BEEP #         CALL           CANCEL #
  9945.                  COLOR #        DELAY #        DRAWBOX #      DRAWHLINE #
  9946.                  DRAWVLINE #    ECHO *         ECHOS #        ENDLOCAL #
  9947.                  GOSUB #        GOTO *         FOR *          IF *
  9948.                  IFF #          INKEY #        INPUT #        KEYSTACK #
  9949.                  LOADBTM #      PAUSE *        QUIT #         REM *
  9950.                  RETURN #       SCREEN #       SCRPUT #       SETLOCAL #
  9951.                  SHIFT *        TEXT #         TIMER #        UNALIAS #
  9952.                  VSCRPUT #
  9953.  
  9954.               Other commands:
  9955.  
  9956.                  ? #            CLS *          ESET #         EXCEPT #
  9957.                  EXIT *         GLOBAL #       HELP #         HISTORY #
  9958.  
  9959.  
  9960.           ___________________________________________________________________
  9961.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  167
  9962.  
  9963.                                           CHAPTER 8 / COMMAND REFERENCE GUIDE
  9964.           ___________________________________________________________________
  9965.  
  9966.  
  9967.                  LIST #         LOG #          PATH *         SELECT #
  9968.                  SET *          TEE #          TYPE *         UNSET #
  9969.                  Y #
  9970.  
  9971.               As you can see, most 4DOS commands are either enhanced
  9972.               traditional commands or are entirely new.  If you are
  9973.               comfortable using traditional commands, you can switch to 4DOS
  9974.               without making any changes in your habits.  But you will be
  9975.               missing a lot of the power of 4DOS's enhancements and new
  9976.               commands unless you take a few minutes to see what's available
  9977.               here.  Make sure you don't skip a section of this reference
  9978.               just because you already know how to use a traditional command
  9979.               with the same name.
  9980.  
  9981.               We have made no attempt to document external DOS commands in
  9982.               this reference, partly because they are explained in your DOS
  9983.               manual, and partly because the number and name of DOS external
  9984.               commands, and the options available with each command, vary
  9985.               widely from one version of DOS to another and from one
  9986.               computer manufacturer to another.  The 4DOS HELP system does
  9987.               include information on standard DOS external commands.
  9988.  
  9989.               If you come across terms or concepts in this chapter that you
  9990.               are unsure about, please refer to Chapter 4 / General
  9991.               Concepts, the Glossary on page 355, or the Index.
  9992.  
  9993.  
  9994.           How to Use the Command Descriptions
  9995.  
  9996.               Each of the 4DOS commands is described in detail on the
  9997.               following pages.  The descriptions are arranged
  9998.               alphabetically, and each includes examples that will help you
  9999.               learn to use the commands.
  10000.  
  10001.               Each description begins with the name of the command on the
  10002.               left side of the page and a word in parentheses on the right
  10003.               side.  The commands marked "New" are unique to 4DOS.  Those
  10004.               marked "Enhanced" are similar to traditional commands but add
  10005.               new features and options.  The commands marked "Compatible"
  10006.               follow the syntax and features of the traditional command with
  10007.               the same name.
  10008.  
  10009.               The name is followed by a sentence or two that briefly
  10010.               describes the command's purpose or major function.  That
  10011.               sentence should help you determine quickly whether you have
  10012.               found the command you are seeking.
  10013.  
  10014.  
  10015.  
  10016.  
  10017.           ___________________________________________________________________
  10018.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  168
  10019.  
  10020.                                           CHAPTER 8 / COMMAND REFERENCE GUIDE
  10021.           ___________________________________________________________________
  10022.  
  10023.  
  10024.               The next part of each description shows the command's format
  10025.               or syntax.  The format line uses certain conventions to
  10026.               describe how the command should be entered and to create
  10027.               reference points for the text describing the command:
  10028.  
  10029.                    Words in UPPER CASE must be spelled exactly as they are
  10030.                    shown (although you can type them in using either upper
  10031.                    or lower case, or a combination).  If a word is shown
  10032.                    partly in upper case (for example BLInk), only the upper
  10033.                    case portion is required, the rest is optional.
  10034.  
  10035.                    Words shown in italics (for example source or filename)
  10036.                    are meant to be replaced by other words or values.  Each
  10037.                    of these words is explained directly beneath the format
  10038.                    line, and discussed in more detail in the text
  10039.                    description of the command.  When the word stands for a
  10040.                    file name, the name may be a simple file name like
  10041.                    MYFILE.TXT or it may include a drive letter and/or a full
  10042.                    path, like C:\MYDIR1\MYDIR2\MYFILE.TXT.  If the command
  10043.                    can work on multiple files, you can use the 4DOS
  10044.                    wildcards, multiple file names, or an include list (see
  10045.                    pages 71, 74, and 74).
  10046.  
  10047.                    Anything followed by an ellipsis (three periods [...])
  10048.                    may be repeated as often as you wish.
  10049.  
  10050.                    Text shown in [square brackets] is optional.  Text
  10051.                    outside of square brackets must be entered literally (if
  10052.                    it is capitalized) or replaced by other words or values
  10053.                    (if it is in italics).
  10054.  
  10055.                    Vertical bars | represent a choice;  you can pick one
  10056.                    option or another but not both.  For example, the
  10057.                    following format shows that the command may be followed
  10058.                    by the word ON or the word OFF, but not both:
  10059.  
  10060.                         COMMAND [ ON | OFF ]
  10061.  
  10062.                    A slash followed by a letter, like [/X], is an "option"
  10063.                    or "switch" which controls the effect of a command.  Many
  10064.                    commands have several switches, and you are usually free
  10065.                    to use none, one, or several to make a command behave as
  10066.                    you wish.  If you use a single switch, you must precede
  10067.                    it with a slash.  If you use several switches, in most
  10068.                    cases you can put them together with one slash or use
  10069.                    separate slashes.  For example, if you wanted to use
  10070.                    switches X, Y, and Z for a command, you could type them
  10071.                    three different ways:
  10072.  
  10073.  
  10074.           ___________________________________________________________________
  10075.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  169
  10076.  
  10077.                                           CHAPTER 8 / COMMAND REFERENCE GUIDE
  10078.           ___________________________________________________________________
  10079.  
  10080.  
  10081.                         command /x /y /z
  10082.                         command /x/y/z
  10083.                         command /xyz
  10084.  
  10085.                    A few switches, particularly in the DIR and SELECT
  10086.                    commands,  use two or more characters.  If you need to
  10087.                    follow a multi-letter switch with another switch, the
  10088.                    second switch must have its own slash to avoid ambiguity.
  10089.  
  10090.               Included in the format section is an explanation of each
  10091.               replaceable argument and a one or two word explanation of each
  10092.               switch.  Many descriptions also list related commands to help
  10093.               you find the exact command you want.
  10094.  
  10095.               After the command format, you'll find a description of the
  10096.               command's usage.  This description normally starts with the
  10097.               basic functions of a command and gradually adds more details.
  10098.               We've also included many examples to help you see the command
  10099.               in action.  In the examples, characters in bold type represent
  10100.               input from the user.  Characters in normal type represent 4DOS
  10101.               prompts or responses, or lines in a batch file.
  10102.  
  10103.               The last part of each description is a detailed explanation of
  10104.               the options or switches available for each command, in
  10105.               alphabetical order.  Occasionally, we've included more
  10106.               examples in this section to demonstrate how a switch is used
  10107.               or how multiple switches interact.
  10108.  
  10109.               Pay careful attention to the information about switch
  10110.               placement.  Some switches have different effects based on
  10111.               where they appear in the command line.  The effects of
  10112.               switches occasionally vary from one command to another in
  10113.               order to retain compatibility with traditional commands.
  10114.  
  10115.               In the Usage and Options sections you may see the symbol## .
  10116.               This indicates a more in-depth discussion or an advanced topic
  10117.               which you can skip if you are new to the command; come back to
  10118.               this topic later for more details, or if you're having trouble
  10119.               with the command.  In most cases the remainder of the section
  10120.               after such a symbol is devoted to similar information.
  10121.  
  10122.               The ## doesn't mean that only advanced users will need the
  10123.               information -- you may find it useful even if you're
  10124.               relatively new to computers or to 4DOS.  But it does mean that
  10125.               you can skip the marked section and still understand and use
  10126.               the basic features of the command.  If a ## appears before the
  10127.               "Usage" heading, it indicates that the entire command is
  10128.  
  10129.  
  10130.  
  10131.           ___________________________________________________________________
  10132.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  170
  10133.  
  10134.                                           CHAPTER 8 / COMMAND REFERENCE GUIDE
  10135.           ___________________________________________________________________
  10136.  
  10137.  
  10138.               generally used only in unusual situations or by more advanced
  10139.               users.
  10140.  
  10141.               When you see a ## in the list of options, remember that the
  10142.               options are listed alphabetically, so there may be more basic
  10143.               options discussed later in the list, after a more complex or
  10144.               advanced option marked with## .  Don't stop reading the option
  10145.               list the first time you see the mark.
  10146.  
  10147.               A ! to the left of a paragraph means that paragraph contains a
  10148.               caution or warning you may need to observe when using the
  10149.               feature it discusses.
  10150.  
  10151.  
  10152.  
  10153.  
  10154.  
  10155.  
  10156.  
  10157.  
  10158.  
  10159.  
  10160.  
  10161.  
  10162.  
  10163.  
  10164.  
  10165.  
  10166.  
  10167.  
  10168.  
  10169.  
  10170.  
  10171.  
  10172.  
  10173.  
  10174.  
  10175.  
  10176.  
  10177.  
  10178.  
  10179.  
  10180.  
  10181.  
  10182.  
  10183.  
  10184.  
  10185.  
  10186.  
  10187.  
  10188.           ___________________________________________________________________
  10189.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  171
  10190.  
  10191.                                     CHAPTER 8 / COMMAND REFERENCE GUIDE  /  ?
  10192.           ___________________________________________________________________
  10193.  
  10194.  
  10195.           ?                                                             (New)
  10196.  
  10197.           Purpose:    Display a list of 4DOS commands.
  10198.  
  10199.           Format:     ?
  10200.  
  10201.           Usage:      ? displays a list of 4DOS internal commands.  For help
  10202.                       with these commands, and with external DOS commands,
  10203.                       see the HELP command.
  10204.  
  10205.                       When you use the ? command, you will see a display like
  10206.                       this:
  10207.  
  10208.                            c:\> ?
  10209.                            ?            ALIAS       ATTRIB       BEEP
  10210.                            BREAK        CALL        CANCEL       CD
  10211.                            CDD          CHCP        CHDIR        CLS
  10212.                            COLOR        COPY        CTTY         DATE
  10213.                            DEL          DELAY       DESCRIBE     DIR
  10214.                            DIRS         DRAWBOX     DRAWHLINE    DRAWVLINE
  10215.                            ECHO         ECHOS       ENDLOCAL     ERASE
  10216.                            ESET         EXCEPT      EXIT         FOR
  10217.                            FREE         GLOBAL      GOSUB        GOTO
  10218.                            HELP         HISTORY     IF           IFF
  10219.                            INKEY        INPUT       KEYSTACK     LH
  10220.                            LIST         LOADBTM     LOADHIGH     LOG
  10221.                            MD           MEMORY      MKDIR        MOVE
  10222.                            PATH         PAUSE       POPD         PROMPT
  10223.                            PUSHD        QUIT        RD           REBOOT
  10224.                            REM          REN         RENAME       RETURN
  10225.                            RMDIR        SCREEN      SCRPUT       SELECT
  10226.                            SET          SETDOS      SETLOCAL     SHIFT
  10227.                            SWAPPING     TEE         TEXT         TIME
  10228.                            TIMER        TRUENAME    TYPE         UNALIAS
  10229.                            UNSET        VER         VERIFY       VOL
  10230.                            VSCRPUT      Y
  10231.  
  10232.                       If you have disabled a command with the SETDOS /I
  10233.                       command, it will not appear in the list.
  10234.  
  10235.  
  10236.  
  10237.  
  10238.  
  10239.  
  10240.  
  10241.  
  10242.  
  10243.  
  10244.  
  10245.           ___________________________________________________________________
  10246.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  172
  10247.  
  10248.                                 CHAPTER 8 / COMMAND REFERENCE GUIDE  /  ALIAS
  10249.           ___________________________________________________________________
  10250.  
  10251.  
  10252.           ALIAS                                                         (New)
  10253.  
  10254.           Purpose:    Create new command names that execute one or more
  10255.                       commands or redefine default options for existing
  10256.                       commands;  assign commands to keystrokes;  load or
  10257.                       display the list of defined alias names.
  10258.  
  10259.           Format:     ALIAS [/P /R file...] [name[=][value]]
  10260.  
  10261.                       file:  One or more files to read for alias definitions.
  10262.                       name:  Name for an alias, or the key to execute the
  10263.                       alias.
  10264.                       value:  Text (commands, etc.) to be substituted for the
  10265.                       alias name.
  10266.  
  10267.                       /P(ause)                    /R(ead file)
  10268.  
  10269.                       See also: UNALIAS and page 96.
  10270.  
  10271.           Usage:      The ALIAS command lets you create new command names or
  10272.                       redefine the 4DOS internal commands.  It also lets you
  10273.                       assign one or more commands to a single keystroke.  An
  10274.                       alias is often used to execute a complex series of
  10275.                       commands with a few keystrokes or to create "in memory
  10276.                       batch files" that run much faster than disk-based batch
  10277.                       files.
  10278.  
  10279.                       For example, if you would rather type D instead of DIR
  10280.                       /W you would use the command:
  10281.  
  10282.                            c:\> alias d = `dir /w`
  10283.  
  10284.                       Now when you type a single d as a command, 4DOS will
  10285.                       translate it into a DIR /W command.  The marks around
  10286.                       DIR /W in the ALIAS command are back-quotes, below the
  10287.                       tilde [~] on most PC keyboards.  They are NOT single
  10288.                       quotes ['].
  10289.  
  10290.                       An alias can represent more than one command.  For
  10291.                       example:
  10292.  
  10293.                            c:\> alias letters = `cd \letters ^ text`
  10294.  
  10295.                       creates a new command called LETTERS.  The command
  10296.                       first uses CD to change to a subdirectory called
  10297.                       \LETTERS and then runs a program called TEXT.  The
  10298.                       caret [^] is the 4DOS command separator and tells 4DOS
  10299.  
  10300.  
  10301.  
  10302.           ___________________________________________________________________
  10303.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  173
  10304.  
  10305.                                 CHAPTER 8 / COMMAND REFERENCE GUIDE  /  ALIAS
  10306.           ___________________________________________________________________
  10307.  
  10308.  
  10309.                       that the two commands are distinct and should be
  10310.                       executed sequentially.
  10311.  
  10312.                       When you type alias commands at the command line or in
  10313.                       a batch file, you MUST use back quotes around the
  10314.                       definition if it contains multiple commands or any
  10315.                       replaceable parameters (which are discussed below), to
  10316.                       prevent premature expansion of the arguments.  You MAY
  10317.                       use back quotes [`] around other definitions, but they
  10318.                       are not required.  To avoid confusion, we recommend
  10319.                       that you always use back quotes around alias
  10320.                       definitions you type at the command line or enter in a
  10321.                       batch file.
  10322.  
  10323.                       Aliases may invoke internal 4DOS commands, external
  10324.                       commands, or other aliases.  (However, an alias may not
  10325.                       invoke itself, except in special cases where an IF or
  10326.                       IFF command is used to prevent an infinite loop.)  The
  10327.                       two aliases below demonstrate alias nesting (one alias
  10328.                       invoking another).  The first line defines an alias
  10329.                       which runs a program called WP.EXE that is in the
  10330.                       E:\WP51\ subdirectory.  The second alias changes
  10331.                       directories with the PUSHD command, runs the WP alias,
  10332.                       and then returns to the original directory with the
  10333.                       POPD command:
  10334.  
  10335.                            c:\> alias wp = `e:\wp51\wp.exe`
  10336.                            c:\> alias w = `pushd c:\wp ^ wp ^ popd`
  10337.  
  10338.                       The second alias above could have included the full
  10339.                       path and name of the WP.EXE program instead of calling
  10340.                       the WP alias.  However, writing two aliases makes the
  10341.                       second one easier to read and understand, and makes the
  10342.                       first alias available for independent use.  If you
  10343.                       rename the WP.EXE program or move it to a new
  10344.                       directory, only the first alias needs to rewritten.
  10345.  
  10346.                       If you put an asterisk [*] immediately before a command
  10347.                       in the value of an alias definition (the part after the
  10348.                       equal sign), it tells 4DOS not to attempt to interpret
  10349.                       that command as another (nested) alias.  An asterisk
  10350.                       used this way must be preceded by a space or caret [^]
  10351.                       and followed immediately by an internal or external
  10352.                       command name.  The asterisk is used to make sure that
  10353.                       4DOS interprets the following word as the name of an
  10354.                       internal or external command instead of as an alias
  10355.                       which may have the same name.  It also allows two
  10356.                       popular uses of aliases.
  10357.  
  10358.  
  10359.           ___________________________________________________________________
  10360.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  174
  10361.  
  10362.                                 CHAPTER 8 / COMMAND REFERENCE GUIDE  /  ALIAS
  10363.           ___________________________________________________________________
  10364.  
  10365.  
  10366.                       By using an asterisk, you can redefine the default
  10367.                       options for any 4DOS command.  For example, suppose
  10368.                       that you always want to use the DIR command with the /2
  10369.                       (two column) and /P (pause at the end of each page)
  10370.                       options.  The following line will do just that:
  10371.  
  10372.                            c:\> alias dir = `*dir /2/p`
  10373.  
  10374.                       If you didn't include the asterisk, 4DOS would
  10375.                       interpret the second DIR on the line as the name of the
  10376.                       alias itself and attempt to repeatedly re-invoke the
  10377.                       DIR alias, rather than running the DIR command.  This
  10378.                       would cause an "Alias loop" or "Command line too long"
  10379.                       error.  The asterisk tells 4DOS to interpret the second
  10380.                       DIR as a command but not as an alias.
  10381.  
  10382.                       An asterisk also helps you keep the names of internal
  10383.                       4DOS commands from conflicting with the names of
  10384.                       external programs.  For example, suppose you have a
  10385.                       program called LIST.COM.  Normally, the 4DOS internal
  10386.                       command will run anytime you type LIST.  But two simple
  10387.                       aliases will give you access to both the LIST.COM
  10388.                       program and the LIST command:
  10389.  
  10390.                            c:\> alias list = `c:\util\list.com`
  10391.                            c:\> alias display = `*list`
  10392.  
  10393.                       The first line above defines LIST as an alias for the
  10394.                       LIST.COM program.  If you stopped there, the external
  10395.                       program would run every time you typed LIST and you
  10396.                       would not have easy access to the internal 4DOS LIST
  10397.                       command.  The second line renames the internal LIST
  10398.                       command as DISPLAY.  The asterisk is needed in the
  10399.                       second command to tell 4DOS that the following word
  10400.                       means the internal command LIST, not the LIST alias
  10401.                       which runs your external program.
  10402.  
  10403.                       Another way to understand the asterisk is to remember
  10404.                       that when 4DOS processes a command it always checks for
  10405.                       an alias first, then looks for an internal or external
  10406.                       command, or a batch file (see page 43).  The asterisk
  10407.                       at the beginning of a command name simply tells 4DOS to
  10408.                       skip over the usual check for aliases when processing
  10409.                       that command, and go straight to checking for an
  10410.                       internal command, external command, or batch file.
  10411.  
  10412.                       You can also use an asterisk before a command that you
  10413.                       enter at the command line or in a batch file.  If you
  10414.  
  10415.  
  10416.           ___________________________________________________________________
  10417.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  175
  10418.  
  10419.                                 CHAPTER 8 / COMMAND REFERENCE GUIDE  /  ALIAS
  10420.           ___________________________________________________________________
  10421.  
  10422.  
  10423.                       do, 4DOS won't try to interpret that command as an
  10424.                       alias.  This can be useful when you want to be sure you
  10425.                       are running the true, original command and not an alias
  10426.                       with the same name, or temporarily defeat the purpose
  10427.                       of an alias which changes the meaning or behavior of a
  10428.                       command.  For example, above we defined an alias for
  10429.                       DIR which made directories display in 2-column paged
  10430.                       mode by default.  If you wanted to see a directory
  10431.                       display in the normal single-column, non-paged mode,
  10432.                       you could enter the command *DIR and the alias would be
  10433.                       ignored during that one command.
  10434.  
  10435.                       You can also use an asterisk in the name of an alias.
  10436.                       When you do, the characters following the asterisk are
  10437.                       optional when you invoke the alias command.  (Use of an
  10438.                       asterisk in the alias name is unrelated to the use of
  10439.                       an asterisk in the alias value discussed above.)  For
  10440.                       example, with this alias:
  10441.  
  10442.                            c:\> alias wher*eis = `dir /sp`
  10443.  
  10444.                       the new command, WHEREIS, can be invoked as WHER,
  10445.                       WHERE, WHEREI, or WHEREIS.  Now if you type:
  10446.  
  10447.                            c:\> where myfile.txt
  10448.  
  10449.                       4DOS will expand the WHEREIS alias and process the
  10450.                       command:
  10451.  
  10452.                            dir /sp myfile.txt
  10453.  
  10454.                       If you want to assign an alias to a keystroke, use the
  10455.                       keyname on the left side of the equal sign, preceded by
  10456.                       an at-sign [@].  For example, to assign the command DIR
  10457.                       /W to the F5 key, type
  10458.  
  10459.                            c:\> alias @F5 = `dir /w`
  10460.  
  10461.                       Keynames must be in the form
  10462.  
  10463.                                 [Prefix-]Keyname
  10464.  
  10465.                       The key prefix can be any one of the following:
  10466.  
  10467.                         No prefix  followed by F1 - F12
  10468.                         Alt        followed by A - Z, 0 - 9, F1 - F12, or
  10469.                                    Bksp
  10470.  
  10471.  
  10472.  
  10473.           ___________________________________________________________________
  10474.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  176
  10475.  
  10476.                                 CHAPTER 8 / COMMAND REFERENCE GUIDE  /  ALIAS
  10477.           ___________________________________________________________________
  10478.  
  10479.  
  10480.                         Ctrl       followed by A - Z, F1 - F12, Bksp, Enter,
  10481.                                    Left, Right, Home, End, PgUp, PgDn, Ins,
  10482.                                    or Del
  10483.  
  10484.                       The possible key names are:
  10485.  
  10486.                         A - Z         Enter         PgDn
  10487.                         0 - 9         Up            Home
  10488.                         F1 - F12      Down          End
  10489.                         Esc           Left          Ins
  10490.                         Bksp          Right         Del
  10491.                         Tab           PgUp
  10492.  
  10493.                       All key names must be spelled as shown, and can be
  10494.                       abbreviated as long as the abbreviation is unique and
  10495.                       unambiguous.  Alphabetic keys can be specified in
  10496.                       upper-case or lower-case.  You cannot specify a
  10497.                       punctuation key.
  10498.  
  10499.                       The prefix and key name must be separated by a dash.
  10500.                       You can also define a keystroke alias by using "@" plus
  10501.                       a scan code for one of the permissible keys (see
  10502.                       Appendix B on page 338 for a list of scan codes).
  10503.  
  10504.                       Some keys are interpreted by your system's BIOS and are
  10505.                       not passed on to 4DOS (for example, Ctrl-S tells the
  10506.                       BIOS to pause screen output temporarily).  Such
  10507.                       keystrokes cannot normally be used for keystroke
  10508.                       aliases, because 4DOS never receives them.  You may not
  10509.                       be able to remap F11 and F12 if your keyboard is not
  10510.                       100% IBM-compatible, or if you have an ANSI driver
  10511.                       which does not support these keys.  This limitation is
  10512.                       due to DOS and your ANSI driver, not 4DOS.
  10513.  
  10514.                       When you define keystroke aliases, the assignments will
  10515.                       only be in effect at the 4DOS command line, not inside
  10516.                       application programs.  Be careful not to assign aliases
  10517.                       to keys that are already used at the command-line (like
  10518.                       F1 for Help).  The command-line meanings take
  10519.                       precedence and the keystroke alias will never be
  10520.                       invoked.  If you want to use one of the command-line
  10521.                       keys for an alias instead of its normal meaning, you
  10522.                       must first disable its regular use with the NormalKey
  10523.                       or NormalEditKey directive in your 4DOS.INI file.  See
  10524.                       page 134 for instructions.
  10525.  
  10526.                       If you define a keystroke alias like this:
  10527.  
  10528.  
  10529.  
  10530.           ___________________________________________________________________
  10531.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  177
  10532.  
  10533.                                 CHAPTER 8 / COMMAND REFERENCE GUIDE  /  ALIAS
  10534.           ___________________________________________________________________
  10535.  
  10536.  
  10537.                            c:\> alias @f5 = `dir /w`
  10538.  
  10539.                       then, when you press the F5 key, 4DOS will enter the
  10540.                       value, "dir /w" on the command line for you.  You can
  10541.                       type additional parameters if you wish and then press
  10542.                       Enter to execute the command.  With this particular
  10543.                       alias, you can define the files that you want to
  10544.                       display after pressing F5 and before pressing Enter to
  10545.                       execute the command.
  10546.  
  10547.                       If you want the keystroke alias to take action
  10548.                       automatically without waiting for you to edit the
  10549.                       command line or press Enter, you must end the value
  10550.                       with a carriage return.  To enter the carriage return
  10551.                       into your alias use the 4DOS escape character (normally
  10552.                       Ctrl-X, shown here as "^X") twice, followed by an "r."
  10553.                       For example, this command will assign an alias to the
  10554.                       F6 key that uses the CDD command to take you back to
  10555.                       the previous default directory:
  10556.  
  10557.                            c:\> alias @f6 = `cdd -^X^Xr`
  10558.  
  10559.                       If you define a keystroke alias in an ALIAS /R file and
  10560.                       you want an the alias to start automatically, use a
  10561.                       single ^X character before the "r" at the end of the
  10562.                       line.  The double ^X is only required when the alias is
  10563.                       defined on the command line or in a batch file.
  10564.  
  10565.                       If you want to see a list of all current ALIAS
  10566.                       commands, type
  10567.  
  10568.                            c:\> alias
  10569.  
  10570.                       You can also view the definition of a single alias.  If
  10571.                       you want to see the definition of the alias LIST, you
  10572.                       can type
  10573.  
  10574.                            c:\> alias list
  10575.  
  10576.                       You can save the list to a file called ALIAS.LST this
  10577.                       way:
  10578.  
  10579.                            c:\> alias > alias.lst
  10580.  
  10581.                       You can then reload all the alias definitions in the
  10582.                       file the next time you boot up with the command
  10583.  
  10584.                            c:\> alias /r alias.lst
  10585.  
  10586.  
  10587.           ___________________________________________________________________
  10588.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  178
  10589.  
  10590.                                 CHAPTER 8 / COMMAND REFERENCE GUIDE  /  ALIAS
  10591.           ___________________________________________________________________
  10592.  
  10593.  
  10594.                       This is much faster than defining each alias
  10595.                       individually in a batch file.  If you keep your alias
  10596.                       definitions in a separate file which you load from
  10597.                       AUTOEXEC.BAT, you can edit them with a text editor,
  10598.                       reload the edited file with the ALIAS /R command, and
  10599.                       know that the same alias list will be loaded the next
  10600.                       time you boot your computer.
  10601.  
  10602.                       When you define aliases in a file that will be read
  10603.                       with the ALIAS /R command, you should NOT use back
  10604.                       quotes around the value, even if back-quotes would
  10605.                       normally be required when defining the same alias at
  10606.                       the command line or in a batch file.
  10607.  
  10608.                       To remove an alias, use the UNALIAS command.
  10609.  
  10610.                   ##  Alias commands can use command-line arguments or
  10611.                       replaceable parameters like those in batch files.  4DOS
  10612.                       numbers the command line arguments from %1 to %127.  It
  10613.                       is up to the alias to determine the meaning of each
  10614.                       argument.  Arguments that are referred to in an alias,
  10615.                       but which are missing on the command line, appear as
  10616.                       empty strings inside the alias.
  10617.  
  10618.                       The parameter %n& has a special meaning.  4DOS
  10619.                       interprets it to mean "the entire command line, from
  10620.                       argument n to the end."  If n is not specified, it has
  10621.                       a default value of 1, so %& means "the entire command
  10622.                       line after the alias name."  The special parameter %#
  10623.                       contains the number of command line arguments.
  10624.  
  10625.                       For example, the following alias will change
  10626.                       directories, perform a command, and return to the
  10627.                       original directory:
  10628.  
  10629.                            c:\> alias in `pushd %1 ^ %2& ^ popd`
  10630.  
  10631.                       When this alias is invoked as:
  10632.  
  10633.                            c:\> in c:\comm mycomm /xmodem /2400
  10634.  
  10635.                       the first replaceable parameter, %1, has the value
  10636.                       "c:\comm."  %2 is "mycomm," %3 is "/xmodem," and %4 is
  10637.                       "/2400".  4DOS expands the command line into these
  10638.                       three separate commands:
  10639.  
  10640.                            pushd c:\comm
  10641.                            mycomm /xmodem /2400
  10642.  
  10643.  
  10644.           ___________________________________________________________________
  10645.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  179
  10646.  
  10647.                                 CHAPTER 8 / COMMAND REFERENCE GUIDE  /  ALIAS
  10648.           ___________________________________________________________________
  10649.  
  10650.  
  10651.                            popd
  10652.  
  10653.                   ##  This next example uses the IFF command to redefine the
  10654.                       defaults for SET only if no other options are entered
  10655.                       on the command line.  This ALIAS command should be
  10656.                       entered on one line:
  10657.  
  10658.                            c:\> alias set = `iff %#==0 then ^ *set /p ^
  10659.                                 else ^ *set %& ^ endiff`
  10660.  
  10661.                       This example modifies the SET command so that if SET is
  10662.                       entered with no arguments, it is replaced by SET /P
  10663.                       (pause after displaying each page), but if SET is
  10664.                       followed by an argument, it behaves normally.  Note the
  10665.                       use of asterisks (*set) to prevent alias loops.
  10666.  
  10667.                   ##  If an alias uses replaceable parameters, 4DOS will
  10668.                       delete command line arguments up to and including the
  10669.                       highest referenced argument.  For example, if you have
  10670.                       an alias which refers only to %1 and %4, then the first
  10671.                       and fourth arguments passed to the alias will be used,
  10672.                       the second and third arguments will be discarded, and
  10673.                       any additional arguments beyond the fourth will be
  10674.                       appended to the end of the expanded command after the
  10675.                       value portion of the alias.  If an alias uses no
  10676.                       replaceable parameters, all of the command line
  10677.                       arguments will be appended to the expanded command.
  10678.  
  10679.                   ##  Aliases also have full access to all variables in the
  10680.                       environment, 4DOS's internal variables, and 4DOS's
  10681.                       variable functions.  For example, you can create a
  10682.                       simple command-line calculator this way (enter this on
  10683.                       one line):
  10684.  
  10685.                            c:\> alias calc = `echo The answer is:
  10686.                                 %@eval[%&]`
  10687.  
  10688.                       Now, if you enter
  10689.  
  10690.                            c:\> calc 5 * 6
  10691.  
  10692.                       4DOS will display
  10693.  
  10694.                            The answer is: 30
  10695.  
  10696.                   ##  Aliases created in the primary shell will be inherited
  10697.                       automatically in a secondary shell.  However, an alias
  10698.  
  10699.  
  10700.  
  10701.           ___________________________________________________________________
  10702.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  180
  10703.  
  10704.                                 CHAPTER 8 / COMMAND REFERENCE GUIDE  /  ALIAS
  10705.           ___________________________________________________________________
  10706.  
  10707.  
  10708.                       created in a secondary shell will not be passed back to
  10709.                       a primary or parent shell.
  10710.  
  10711.           Options:    /P(ause):  This option is only effective when ALIAS is
  10712.                       used to display existing definitions.  It pauses the
  10713.                       display after each page and waits for a keystroke
  10714.                       before continuing.
  10715.  
  10716.                       /R(ead file):  This option loads an alias list from a
  10717.                       file.  The format of the file is the same as that of
  10718.                       the ALIAS display:
  10719.  
  10720.                                 name=value
  10721.  
  10722.                       where name is the name of the alias and value is its
  10723.                       value.  You can use an equal sign [=] or space to
  10724.                       separate the name and value.  Back-quotes should NOT be
  10725.                       used around the value.  You can add comments to the
  10726.                       file by starting each comment line with a colon [:].
  10727.                       You can load multiple files with one ALIAS /R command
  10728.                       by placing the names one after another on the command
  10729.                       line, separated by spaces:
  10730.  
  10731.                            c:\> alias /r alias1.lst alias2.lst
  10732.  
  10733.                       Lines in an ALIAS /R file can be up to 511 characters
  10734.                       long.
  10735.  
  10736.  
  10737.  
  10738.  
  10739.  
  10740.  
  10741.  
  10742.  
  10743.  
  10744.  
  10745.  
  10746.  
  10747.  
  10748.  
  10749.  
  10750.  
  10751.  
  10752.  
  10753.  
  10754.  
  10755.  
  10756.  
  10757.  
  10758.           ___________________________________________________________________
  10759.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  181
  10760.  
  10761.                                CHAPTER 8 / COMMAND REFERENCE GUIDE  /  ATTRIB
  10762.           ___________________________________________________________________
  10763.  
  10764.  
  10765.           ATTRIB                                                        (New)
  10766.  
  10767.           Purpose:    Change or view file and subdirectory attributes.
  10768.  
  10769.           Format:     ATTRIB [/D /Q /P /S] [+|-[AHRS]] files
  10770.  
  10771.                       files: A file, directory, or list of files or
  10772.                       directories, on which to operate.
  10773.  
  10774.                       /D(irectories)              /Q(uiet)
  10775.                       /P(ause)                    /S(ubdirectories)
  10776.  
  10777.                       Attribute flags:
  10778.  
  10779.                            +A   Set the archive attribute
  10780.                            -A   Clear the archive attribute
  10781.                            +H   Set the hidden attribute
  10782.                            -H   Clear the hidden attribute
  10783.                            +R   Set the read-only attribute
  10784.                            -R   Clear the read-only attribute
  10785.                            +S   Set the system attribute
  10786.                            -S   Clear the system attribute
  10787.  
  10788.           Usage:      Every file and subdirectory has 4 attributes that can
  10789.                       be turned on (set) or turned off (cleared): Archive,
  10790.                       Hidden, Read-only, and System.  DOS sets the Archive
  10791.                       attribute every time a file is updated or changed.
  10792.                       Backup utilities often use this attribute to find files
  10793.                       that have changed since the last general backup.  DOS
  10794.                       prevents programs from altering or erasing files that
  10795.                       have the Read-only attribute set (but applications can
  10796.                       change the attribute first and then update or erase the
  10797.                       file).  Files with Hidden and/or System attributes are
  10798.                       normally not visible in directory listings.
  10799.  
  10800.                       The ATTRIB command lets you set or clear any
  10801.                       attribute(s) for any file, group of files, or
  10802.                       subdirectory.  You can view file attributes by entering
  10803.                       ATTRIB without specifying new attributes (i.e. without
  10804.                       the [+|-[AHRS]] part of the format), or with the DIR /T
  10805.                       command.
  10806.  
  10807.                       For example, you can set the read-only and hidden
  10808.                       attributes for the file MEMO:
  10809.  
  10810.                            c:\> attrib +rh memo
  10811.  
  10812.  
  10813.  
  10814.  
  10815.           ___________________________________________________________________
  10816.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  182
  10817.  
  10818.                                CHAPTER 8 / COMMAND REFERENCE GUIDE  /  ATTRIB
  10819.           ___________________________________________________________________
  10820.  
  10821.  
  10822.                       Attribute options apply to the file(s) that follow the
  10823.                       options on the ATTRIB command line.  The example below
  10824.                       shows how to set different attributes on different
  10825.                       files with a single command.  It sets the archive
  10826.                       attribute for all .TXT files, and changes TEST.COM to
  10827.                       system and not modified:
  10828.  
  10829.                            c:\> attrib +a *.txt +s -a test.com
  10830.  
  10831.                   ##  You may know that DOS also supports "D" (subdirectory)
  10832.                       and "V" (volume label) attributes.  These attributes
  10833.                       cannot be altered with ATTRIB;  they are designed to be
  10834.                       controlled only by DOS itself.
  10835.  
  10836.           Options:    /D(irectories):  If you don't use this option, ATTRIB
  10837.                       will only modify file attributes.  If you use the /D
  10838.                       option, ATTRIB will also modify the attributes of
  10839.                       subdirectories (yes, you can have a hidden
  10840.                       subdirectory):
  10841.  
  10842.                            c:\> attrib /d +h c:\mydir
  10843.  
  10844.                       /P(ause):  Wait for a key to be pressed after each
  10845.                       screen page before continuing the display.
  10846.  
  10847.                       /Q(uiet):  This option turns off ATTRIB's normal screen
  10848.                       output.  It is most useful in batch files.
  10849.  
  10850.                       /S(ubdirectories):  If you use the /S option, the
  10851.                       ATTRIB command will be applied to all matching files in
  10852.                       the current or named directory and all of its
  10853.                       subdirectories.
  10854.  
  10855.  
  10856.  
  10857.  
  10858.  
  10859.  
  10860.  
  10861.  
  10862.  
  10863.  
  10864.  
  10865.  
  10866.  
  10867.  
  10868.  
  10869.  
  10870.  
  10871.  
  10872.           ___________________________________________________________________
  10873.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  183
  10874.  
  10875.                                  CHAPTER 8 / COMMAND REFERENCE GUIDE  /  BEEP
  10876.           ___________________________________________________________________
  10877.  
  10878.  
  10879.           BEEP                                                          (New)
  10880.  
  10881.           Purpose:    Beep the speaker or play simple music.
  10882.  
  10883.           Format:     BEEP [frequency duration ...]
  10884.  
  10885.                       frequency  is in Hertz (cycles per second).
  10886.                       duration  is in 1/18th second intervals
  10887.  
  10888.           Usage:      BEEP generates a sound through your computer's speaker.
  10889.                       It is normally used in batch files to signal that an
  10890.                       operation has been completed, or that the computer
  10891.                       needs attention.
  10892.  
  10893.                       Because BEEP allows you to specify the frequency and
  10894.                       duration of the sound, you can also use it to play
  10895.                       simple music or to create different kinds of signals
  10896.                       for the user.
  10897.  
  10898.                       You can include as many frequency and duration pairs as
  10899.                       you wish.  No sound will be generated for frequencies
  10900.                       less than 20 Hz, allowing you to insert short delays.
  10901.                       The default value for frequency is 440 Hz; the default
  10902.                       value for duration is 2.
  10903.  
  10904.                       This batch file fragment runs a program called DEMO,
  10905.                       then plays a few notes and waits for you to press a
  10906.                       key:
  10907.  
  10908.                            demo ^ beep 440 4  600 2  1040 6
  10909.                            pause Finished with the demo - hit a key...
  10910.  
  10911.                       The following table gives the frequency values for a
  10912.                       five octave range (middle C is 262 Hz):
  10913.  
  10914.                            C      131   262   523   1046  2093
  10915.                            C#/Db  139   277   554   1108  2217
  10916.                            D      147   294   587   1174  2349
  10917.                            D#/Eb  156   311   622   1244  2489
  10918.                            E      165   330   659   1318  2637
  10919.                            F      175   349   698   1397  2794
  10920.                            F#/Gb  185   370   740   1480  2960
  10921.                            G      196   392   784   1568  3136
  10922.                            G#/Ab  208   415   831   1662  3322
  10923.                            A      220   440   880   1760  3520
  10924.                            A#/Bb  233   466   932   1864  3729
  10925.                            B      248   494   988   1976  3951
  10926.  
  10927.  
  10928.  
  10929.           ___________________________________________________________________
  10930.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  184
  10931.  
  10932.                                 CHAPTER 8 / COMMAND REFERENCE GUIDE  /  BREAK
  10933.           ___________________________________________________________________
  10934.  
  10935.  
  10936.           BREAK                                                  (Compatible)
  10937.  
  10938.           Purpose:    Display, enable, or disable Ctrl-C and Ctrl-BREAK
  10939.                       checking.
  10940.  
  10941.           Format:     BREAK [ON | OFF]
  10942.  
  10943.           Usage:      The Ctrl-C and Ctrl-Break keys are used by many
  10944.                       programs (including 4DOS) as a signal to interrupt the
  10945.                       current operation.  BREAK controls how often DOS checks
  10946.                       to see if you've entered one of these keystrokes.
  10947.  
  10948.                       Normally, BREAK is turned off, and DOS only checks for
  10949.                       Ctrl-C and Ctrl-Break keystrokes during normal DOS
  10950.                       input or output operations involving the screen,
  10951.                       keyboard, serial port, and printer.  However many
  10952.                       programs don't use DOS for these operations, and it can
  10953.                       be difficult to interrupt them.
  10954.  
  10955.                       When BREAK is turned ON, DOS checks for Ctrl-C and
  10956.                       Ctrl-Break every time a program calls DOS.  Since most
  10957.                       programs use DOS to access files and perform other
  10958.                       functions, turning BREAK on makes it much more likely
  10959.                       that a Ctrl-C or Ctrl-Break will be noticed.  If you
  10960.                       turn BREAK on, programs will run slightly slower than
  10961.                       normal (the difference is not usually noticeable), but
  10962.                       you will be able to break out of some programs more
  10963.                       easily.
  10964.  
  10965.                       Turning BREAK on or off only affects when DOS detects
  10966.                       Ctrl-C and Ctrl-Break and notifies the program you're
  10967.                       running.  Any program can choose to ignore these
  10968.                       signals, in which case the BREAK setting won't affect
  10969.                       that program's behavior.  Also, any external program
  10970.                       can change the BREAK setting on its own.
  10971.  
  10972.                       Type BREAK by itself to display the current BREAK
  10973.                       status:
  10974.  
  10975.                            c:\> break
  10976.                            BREAK is OFF
  10977.  
  10978.                       Type BREAK plus ON or OFF to set the BREAK status:
  10979.  
  10980.                            c:\> break on
  10981.  
  10982.                       BREAK is off by default.  You can change the default by
  10983.                       adding a BREAK=ON command in your CONFIG.SYS file.
  10984.  
  10985.  
  10986.           ___________________________________________________________________
  10987.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  185
  10988.  
  10989.                                  CHAPTER 8 / COMMAND REFERENCE GUIDE  /  CALL
  10990.           ___________________________________________________________________
  10991.  
  10992.  
  10993.           CALL                                                   (Compatible)
  10994.  
  10995.           Purpose:    Execute one batch file from within another.
  10996.  
  10997.           Format:     CALL file
  10998.  
  10999.                       file: The batch file to execute.
  11000.  
  11001.                       See also CANCEL and QUIT.
  11002.  
  11003.           Usage:      CALL allows batch files to call other batch files
  11004.                       (batch file nesting) without starting a secondary copy
  11005.                       of the command processor.  The calling batch file is
  11006.                       suspended while the called (second) batch file runs.
  11007.                       When the second batch file finishes, the original batch
  11008.                       file resumes execution at the next command.  If you
  11009.                       execute a batch file from inside another batch file
  11010.                       without using CALL, the first batch file is terminated
  11011.                       before the second one starts.
  11012.  
  11013.                       The following batch file fragment compares an input
  11014.                       line to "wp" and calls another batch file if it
  11015.                       matches:
  11016.  
  11017.                            input  Enter your choice:  %%option
  11018.                            if "%option" == "wp" call wp.bat
  11019.  
  11020.                       4DOS supports batch file nesting up to ten levels deep.
  11021.  
  11022.                       The current ECHO state will be inherited by a called
  11023.                       batch file.
  11024.  
  11025.                   ##  A called batch file will return to the calling file
  11026.                       after processing the last line in the called file, or
  11027.                       when a QUIT command is executed.  A called batch file
  11028.                       should always return in this way, or terminate all
  11029.                       batch files with CANCEL.  Restarting (or CALLing) the
  11030.                       original batch file from within a called file will
  11031.                       prevent 4DOS from detecting that you've left the second
  11032.                       file, and it may cause an infinite loop or a stack
  11033.                       overflow.
  11034.  
  11035.                   ##  You can also use CALL to invoke an alias, internal
  11036.                       command, or external command.  The command will be
  11037.                       executed just as it would be if CALL were not used.
  11038.                       You may find this useful in advanced batch files which
  11039.                       use CALL to execute other commands without "knowing"
  11040.                       the type of command being executed.
  11041.  
  11042.  
  11043.           ___________________________________________________________________
  11044.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  186
  11045.  
  11046.                                  CHAPTER 8 / COMMAND REFERENCE GUIDE  /  CALL
  11047.           ___________________________________________________________________
  11048.  
  11049.  
  11050.                   ##  CALL returns an exit code which matches the batch file
  11051.                       return code.  You can test this exit code with the %_?
  11052.                       environment variable (see page 81), and use it with
  11053.                       conditional commands (&& and ||; see page 91).
  11054.  
  11055.  
  11056.  
  11057.  
  11058.  
  11059.  
  11060.  
  11061.  
  11062.  
  11063.  
  11064.  
  11065.  
  11066.  
  11067.  
  11068.  
  11069.  
  11070.  
  11071.  
  11072.  
  11073.  
  11074.  
  11075.  
  11076.  
  11077.  
  11078.  
  11079.  
  11080.  
  11081.  
  11082.  
  11083.  
  11084.  
  11085.  
  11086.  
  11087.  
  11088.  
  11089.  
  11090.  
  11091.  
  11092.  
  11093.  
  11094.  
  11095.  
  11096.  
  11097.  
  11098.  
  11099.  
  11100.           ___________________________________________________________________
  11101.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  187
  11102.  
  11103.                                CHAPTER 8 / COMMAND REFERENCE GUIDE  /  CANCEL
  11104.           ___________________________________________________________________
  11105.  
  11106.  
  11107.           CANCEL                                                        (New)
  11108.  
  11109.           Purpose:    Terminate batch file processing.
  11110.  
  11111.           Format:     CANCEL
  11112.  
  11113.                       See also: CALL and QUIT.
  11114.  
  11115.           Usage:      The CANCEL command ends all batch file processing,
  11116.                       regardless of the batch file nesting level.  Use QUIT
  11117.                       to end a nested batch file and return to the previous
  11118.                       batch file.
  11119.  
  11120.                       You can CANCEL at any point in a batch file.  If CANCEL
  11121.                       is used from within an alias it will end execution of
  11122.                       both the alias and any batch file(s) which are running
  11123.                       at the time.
  11124.  
  11125.                       The following batch file fragment compares an input
  11126.                       line to "end" and terminates all batch file processing
  11127.                       if it matches:
  11128.  
  11129.                            input Enter your choice:  %%option
  11130.                            if "%option" == "end" cancel
  11131.  
  11132.  
  11133.  
  11134.  
  11135.  
  11136.  
  11137.  
  11138.  
  11139.  
  11140.  
  11141.  
  11142.  
  11143.  
  11144.  
  11145.  
  11146.  
  11147.  
  11148.  
  11149.  
  11150.  
  11151.  
  11152.  
  11153.  
  11154.  
  11155.  
  11156.  
  11157.           ___________________________________________________________________
  11158.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  188
  11159.  
  11160.                            CHAPTER 8 / COMMAND REFERENCE GUIDE  /  CD / CHDIR
  11161.           ___________________________________________________________________
  11162.  
  11163.  
  11164.           CD / CHDIR                                               (Enhanced)
  11165.  
  11166.           Purpose:    Display or change the current directory.
  11167.  
  11168.           Format:     CD [ path | - ]
  11169.                            or
  11170.                       CHDIR [ path | - ]
  11171.  
  11172.                       path: The directory to change to, including an optional
  11173.                       drive name.
  11174.  
  11175.                       See also: CDD, MD, PUSHD, RD, and CDPATH on page 117.
  11176.  
  11177.           Usage:      CD and CHDIR are synonyms.  You can use either one.
  11178.  
  11179.                       CD lets you navigate through the DOS subdirectory
  11180.                       structure by changing the current working directory.
  11181.                       If you enter CD and a directory name, the named
  11182.                       directory becomes the new current directory.  For
  11183.                       example, to change to the subdirectory
  11184.                       C:\FINANCE\MYFILES:
  11185.  
  11186.                            c:\> cd \finance\myfiles
  11187.                            c:\finance\myfiles>
  11188.  
  11189.                       Every disk drive on the system has its own current
  11190.                       directory.  Specifying both a drive and a directory in
  11191.                       the CD command will change the current directory on the
  11192.                       specified drive, but will not change the default drive.
  11193.                       For example, to change the default directory on drive
  11194.                       A:
  11195.  
  11196.                            c:\> cd a:\utility
  11197.                            c:\>
  11198.  
  11199.                       Notice that this command does not change to drive A:.
  11200.                       Use the CDD command to change both the drive and
  11201.                       directory together.
  11202.  
  11203.                       You can change to the parent directory with CD ..; you
  11204.                       can also go up one additional directory level with each
  11205.                       additional [.].  For example, CD .... will go up three
  11206.                       levels in the directory tree.  You can move to a
  11207.                       sibling directory -- one that branches from the same
  11208.                       parent directory as the current subdirectory -- with
  11209.                       the command CD ..\newdir.
  11210.  
  11211.  
  11212.  
  11213.  
  11214.           ___________________________________________________________________
  11215.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  189
  11216.  
  11217.                            CHAPTER 8 / COMMAND REFERENCE GUIDE  /  CD / CHDIR
  11218.           ___________________________________________________________________
  11219.  
  11220.  
  11221.                       If you enter CD with no argument or with only a disk
  11222.                       drive name, it will display the current directory on
  11223.                       the default or named drive.
  11224.  
  11225.                       CD saves the current directory before changing to a new
  11226.                       directory.  You can switch back to the previous
  11227.                       directory by entering CD -.  (There must be a space
  11228.                       between the CD command and the hyphen.)  You can switch
  11229.                       back and forth between two directories by repeatedly
  11230.                       entering CD -.  The saved directory is the same for
  11231.                       both the CD and CDD commands.  Automatic directory
  11232.                       changes (see page 61) also modify the saved directory,
  11233.                       so you can use CD - to return to a directory that you
  11234.                       exited with an automatic directory change.
  11235.  
  11236.                   ##  CD never changes the default drive.  If you change
  11237.                       directories on one drive, switch to another drive, and
  11238.                       then enter CD -, the directory will be restored on the
  11239.                       first drive but the current drive will not be changed.
  11240.  
  11241.                   ##  If CD can't change to the specified directory, it will
  11242.                       look for the CDPATH environment variable.  CD will
  11243.                       append the specified directory name to each directory
  11244.                       in CDPATH and attempt to change to that directory,
  11245.                       until the first match or the end of the CDPATH
  11246.                       argument.  This lets you use CDPATH as a quick way to
  11247.                       find commonly used subdirectories which have unique
  11248.                       names.  For example, if you are currently in the
  11249.                       directory C:\WP\LETTERS\JANUARY and you'd like to
  11250.                       change to C:\FINANCE\REPORTS, you could enter the
  11251.                       command:
  11252.  
  11253.                            c:\wp\letters\january> cd \finance\reports
  11254.  
  11255.                       However if the C:\FINANCE directory is listed in your
  11256.                       CDPATH variable, and is the first directory in the list
  11257.                       with a REPORTS subdirectory, you can simply enter the
  11258.                       command:
  11259.  
  11260.                            c:\wp\letters\january> cd reports
  11261.  
  11262.                       and 4DOS will change to C:\FINANCE\REPORTS.
  11263.  
  11264.                   ##  DOS will not accept directory names longer than 64
  11265.                       characters.  You must be sure that the complete
  11266.                       directory name from the root to your deepest
  11267.                       subdirectory fits within the 64 character restriction.
  11268.  
  11269.  
  11270.  
  11271.           ___________________________________________________________________
  11272.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  190
  11273.  
  11274.                                   CHAPTER 8 / COMMAND REFERENCE GUIDE  /  CDD
  11275.           ___________________________________________________________________
  11276.  
  11277.  
  11278.           CDD                                                           (New)
  11279.  
  11280.           Purpose:    Change the current disk drive and directory.
  11281.  
  11282.           Format:     CDD path
  11283.  
  11284.                       path:  The name of the directory (or drive and
  11285.                       directory) to change to.
  11286.  
  11287.                       See also: CD, MD, PUSHD, RD, and CDPATH on page 117.
  11288.  
  11289.           Usage:      CDD is similar to the CD command, except that it also
  11290.                       changes the default disk drive if one is specified.
  11291.                       CDD will change to the directory and drive you name.
  11292.                       To change from the root directory on drive A to the
  11293.                       subdirectory C:\WP:
  11294.  
  11295.                            a:\> cdd c:\wp
  11296.                            c:\wp>
  11297.  
  11298.                       You can change to the parent directory with CDD ..; you
  11299.                       can also go up one additional directory level with each
  11300.                       additional [.].  For example, CDD .... will go up three
  11301.                       levels in the directory tree.
  11302.  
  11303.                       CDD saves the current drive and directory before
  11304.                       changing to a new directory.  You can switch back to
  11305.                       the previous drive and directory by entering CDD -.
  11306.                       (There must be a space between the CDD command and the
  11307.                       hyphen.)  You can switch back and forth between two
  11308.                       drives and directories by repeatedly entering CDD -.
  11309.                       The saved directory is the same for both the CD and CDD
  11310.                       commands.  Drive changes and automatic directory
  11311.                       changes (see page 61) also modify the saved directory,
  11312.                       so you can use CD - to return to a directory that you
  11313.                       exited with a drive change or an automatic directory
  11314.                       change.
  11315.  
  11316.                   ##  If CDD can't change to the specified directory, it will
  11317.                       look for the CDPATH environment variable.  CDD will
  11318.                       append the specified directory name to each directory
  11319.                       in CDPATH and attempt to change to that drive and
  11320.                       directory, until the first match or the end of the
  11321.                       CDPATH argument.  This allows you to use CDPATH as a
  11322.                       quick way to find commonly used subdirectories which
  11323.                       have unique names.  For example, if you are currently
  11324.                       in the directory C:\WP\LETTERS\JANUARY and you'd like
  11325.  
  11326.  
  11327.  
  11328.           ___________________________________________________________________
  11329.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  191
  11330.  
  11331.                                   CHAPTER 8 / COMMAND REFERENCE GUIDE  /  CDD
  11332.           ___________________________________________________________________
  11333.  
  11334.  
  11335.                       to change to D:\SOFTWARE\UTIL, you could enter the
  11336.                       command:
  11337.  
  11338.                            c:\wp\letters\january> cdd d:\software\util
  11339.  
  11340.                       However if the D:\SOFTWARE directory is listed in your
  11341.                       CDPATH variable, and is the first directory in the list
  11342.                       with a UTIL subdirectory, you can simply enter the
  11343.                       command:
  11344.  
  11345.                            c:\wp\letters\january> cdd util
  11346.  
  11347.                       and 4DOS will change to D:\SOFTWARE\UTIL.
  11348.  
  11349.                   ##  DOS will not accept directory names longer than 64
  11350.                       characters.  You must be sure that the complete
  11351.                       directory name from the root to your deepest
  11352.                       subdirectory fits within the 64 character restriction.
  11353.  
  11354.  
  11355.  
  11356.  
  11357.  
  11358.  
  11359.  
  11360.  
  11361.  
  11362.  
  11363.  
  11364.  
  11365.  
  11366.  
  11367.  
  11368.  
  11369.  
  11370.  
  11371.  
  11372.  
  11373.  
  11374.  
  11375.  
  11376.  
  11377.  
  11378.  
  11379.  
  11380.  
  11381.  
  11382.  
  11383.  
  11384.  
  11385.           ___________________________________________________________________
  11386.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  192
  11387.  
  11388.                                  CHAPTER 8 / COMMAND REFERENCE GUIDE  /  CHCP
  11389.           ___________________________________________________________________
  11390.  
  11391.  
  11392.           CHCP                                                   (Compatible)
  11393.  
  11394.           Purpose:    Display or change the current system code page.
  11395.  
  11396.           Format:     CHCP [n]
  11397.  
  11398.                       n: A system code page number.
  11399.  
  11400.           ## Usage:   Code page switching allows you to select different
  11401.                       character sets for language support.  To use code page
  11402.                       switching, you must have an EGA or VGA display and MS-
  11403.                       DOS or PC-DOS 3.3 or above.
  11404.  
  11405.                       If you enter CHCP without a number, the current code
  11406.                       page is displayed.
  11407.  
  11408.                            c:\> chcp
  11409.                            Active code page: 437
  11410.  
  11411.                       If you enter CHCP plus a code page number, the system
  11412.                       code page is changed.  For example, to set the code
  11413.                       page to multilingual:
  11414.  
  11415.                            c:\> chcp 850
  11416.  
  11417.                       Before using CHCP, you must first load the device
  11418.                       drivers (in CONFIG.SYS); make sure the information file
  11419.                       (COUNTRY.SYS) is available; load national language
  11420.                       support (using the NLSFUNC command); and prepare the
  11421.                       specified code page for the devices (using the MODE
  11422.                       command with the CODEPAGE PREPARE option).
  11423.  
  11424.                       CHCP accepts one of the two prepared system code pages.
  11425.                       An error message is displayed if a code page is
  11426.                       selected that has not been prepared for the system.
  11427.  
  11428.                       See your DOS manual for more information on CHCP.
  11429.  
  11430.  
  11431.  
  11432.  
  11433.  
  11434.  
  11435.  
  11436.  
  11437.  
  11438.  
  11439.  
  11440.  
  11441.  
  11442.           ___________________________________________________________________
  11443.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  193
  11444.  
  11445.                                   CHAPTER 8 / COMMAND REFERENCE GUIDE  /  CLS
  11446.           ___________________________________________________________________
  11447.  
  11448.  
  11449.           CLS                                                      (Enhanced)
  11450.  
  11451.           Purpose:    Clear the video display and move the cursor to the
  11452.                       upper left corner;  optionally change the default
  11453.                       display and border colors.
  11454.  
  11455.           Format:     CLS [[BRIght] [BLInk] fg ON [BRIght] bg] [BORder bc]
  11456.  
  11457.                       fg:  The new foreground color
  11458.                       bg:  The new background color
  11459.                       bc:  The new border color
  11460.  
  11461.                       The available colors are:
  11462.  
  11463.                         Black         Blue          Green         Red
  11464.                         Magenta       Cyan          Yellow        White
  11465.  
  11466.                       See also: COLOR.
  11467.  
  11468.           Usage:      CLS can be used to clear the screen without changing
  11469.                       colors, or to clear the screen and change the screen
  11470.                       colors simultaneously.  These three examples show how
  11471.                       to clear the screen to the default colors, to bright
  11472.                       white letters on a blue background, and to bright
  11473.                       yellow letters on a magenta background with a blue
  11474.                       border:
  11475.  
  11476.                            c:\> cls
  11477.                            c:\> cls bright white on blue
  11478.                            c:\> cls bri yel on mag bor blu
  11479.  
  11480.                       As shown in the last example, color names plus the
  11481.                       words BRIGHT, BLINK, and BORDER may be shortened to the
  11482.                       first 3 letters.
  11483.  
  11484.                       If you use BRIGHT and/or BLINK at the beginning of the
  11485.                       color specification, 4DOS will apply the appropriate
  11486.                       attribute to the foreground characters.  Bright
  11487.                       backgrounds will not work unless BrightBG is set to Yes
  11488.                       in 4DOS.INI (see page 129).
  11489.  
  11490.                       CLS is often used in batch files to clear the screen
  11491.                       before displaying text.
  11492.  
  11493.                   ##  If ANSI.SYS or a compatible driver is not loaded, the
  11494.                       colors will not be "sticky" -- you may lose them after
  11495.                       you run an application.  If 4DOS thinks you have an
  11496.                       ANSI driver loaded, it first tries an ANSI clear
  11497.  
  11498.  
  11499.           ___________________________________________________________________
  11500.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  194
  11501.  
  11502.                                   CHAPTER 8 / COMMAND REFERENCE GUIDE  /  CLS
  11503.           ___________________________________________________________________
  11504.  
  11505.  
  11506.                       screen.  If that doesn't work, 4DOS will call the BIOS
  11507.                       to clear the screen.  You can force 4DOS to recognize
  11508.                       the ANSI state with the SETDOS /A option (see page 305)
  11509.                       or the ANSI directive in 4DOS.INI (see page 129).
  11510.  
  11511.                       If your display accommodates more than 25 rows by 80
  11512.                       columns and CLS doesn't clear the whole screen, your
  11513.                       ANSI driver probably does not support the large display
  11514.                       size properly.
  11515.  
  11516.  
  11517.  
  11518.  
  11519.  
  11520.  
  11521.  
  11522.  
  11523.  
  11524.  
  11525.  
  11526.  
  11527.  
  11528.  
  11529.  
  11530.  
  11531.  
  11532.  
  11533.  
  11534.  
  11535.  
  11536.  
  11537.  
  11538.  
  11539.  
  11540.  
  11541.  
  11542.  
  11543.  
  11544.  
  11545.  
  11546.  
  11547.  
  11548.  
  11549.  
  11550.  
  11551.  
  11552.  
  11553.  
  11554.  
  11555.  
  11556.           ___________________________________________________________________
  11557.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  195
  11558.  
  11559.                                 CHAPTER 8 / COMMAND REFERENCE GUIDE  /  COLOR
  11560.           ___________________________________________________________________
  11561.  
  11562.  
  11563.           COLOR                                                         (New)
  11564.  
  11565.           Purpose:    Change the default display colors.
  11566.  
  11567.           Format:     COLOR [BRIght] [BLInk] fg ON [BRIght] bg [BORder bc]
  11568.  
  11569.                       fg:  The new foreground color
  11570.                       bg:  The new background color
  11571.                       bc:  The new border color
  11572.  
  11573.                       The available colors are:
  11574.  
  11575.                         Black         Blue          Green         Red
  11576.                         Magenta       Cyan          Yellow        White
  11577.  
  11578.                       See also: CLS.
  11579.  
  11580.           Usage:      COLOR is normally used in batch files before displaying
  11581.                       text.  To set screen colors to bright white on blue,
  11582.                       you can use either of these commands:
  11583.  
  11584.                            c:\> color bright white on blue
  11585.                            c:\> color bri whi on blu
  11586.  
  11587.                       As the examples show, you may shorten color names plus
  11588.                       the words BRIGHT, BLINK, and BORDER to the first 3
  11589.                       letters.  Bright backgrounds will not work unless
  11590.                       BrightBG is set to Yes in 4DOS.INI (see page 129).
  11591.  
  11592.                       If you have an ANSI driver (such as ANSI.SYS)
  11593.                       installed, COLOR will not change anything on the
  11594.                       screen.  It will only set the default colors for
  11595.                       subsequent screen displays.
  11596.  
  11597.                       If you are not using an ANSI driver, COLOR will change
  11598.                       the display colors of every character on the screen.
  11599.                       However, the colors will not be "sticky" -- you may
  11600.                       lose them after you run an application.
  11601.  
  11602.                   ##  If you see odd characters like "[44;37m" when you try
  11603.                       to set the screen colors, 4DOS probably thinks you have
  11604.                       an ANSI driver loaded when you don't.  Use SETDOS /A2,
  11605.                       or ANSI = No in 4DOS.INI, to tell 4DOS you have no ANSI
  11606.                       driver.
  11607.  
  11608.  
  11609.  
  11610.  
  11611.  
  11612.  
  11613.           ___________________________________________________________________
  11614.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  196
  11615.  
  11616.                                  CHAPTER 8 / COMMAND REFERENCE GUIDE  /  COPY
  11617.           ___________________________________________________________________
  11618.  
  11619.  
  11620.           COPY                                                     (Enhanced)
  11621.  
  11622.           Purpose:    Copy data between disks, directories, files, or
  11623.                       physical hardware devices (such as your printer or
  11624.                       serial port).
  11625.  
  11626.           Format:     COPY [/C /H /M /N/ /P /Q /S /R /U /V] source[+] ...
  11627.                            [/A /B] destination [/A /B]
  11628.  
  11629.                       source: A file or list of files or a device to copy
  11630.                       from.
  11631.                       destination: A file, directory, or device to copy to.
  11632.  
  11633.                       /A(SCII)                    /P(rompt)
  11634.                       /B(inary)                   /Q(uiet)
  11635.                       /C(hanged)                  /R(eplace)
  11636.                       /H(idden)                   /S(ubdirectories)
  11637.                       /M(odified)                 /U(pdate)
  11638.                       /N(othing)                  /V(erify)
  11639.  
  11640.                       See also: ATTRIB, MOVE, and REN.
  11641.  
  11642.           Usage:      The 4DOS COPY command accepts all traditional syntax
  11643.                       and options and adds several new features.
  11644.  
  11645.                       The simplest use of COPY is to make a copy of a file,
  11646.                       like this example which makes a copy of a file called
  11647.                       file1.abc:
  11648.  
  11649.                            c:\> copy file1.abc file2.def
  11650.  
  11651.                       You can also copy a file to another drive and/or
  11652.                       directory.  The following command copies file1 to the
  11653.                       \MYDIR directory on drive E:
  11654.  
  11655.                            c:\> copy file1 e:\mydir
  11656.  
  11657.                       You can copy several files at once by using wildcards:
  11658.  
  11659.                            c:\> copy *.txt e:\mydir
  11660.  
  11661.                       (See page 71 for an explanation of how 4DOS interprets
  11662.                       the wildcard characters [*] and [?].)
  11663.  
  11664.                       4DOS also lets you copy several files at one time.  The
  11665.                       following command copies 3 files from the current
  11666.                       directory to the \MYDIR directory on drive E:
  11667.  
  11668.  
  11669.  
  11670.           ___________________________________________________________________
  11671.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  197
  11672.  
  11673.                                  CHAPTER 8 / COMMAND REFERENCE GUIDE  /  COPY
  11674.           ___________________________________________________________________
  11675.  
  11676.  
  11677.                            c:\> copy file1 file2 file3 e:\mydir
  11678.  
  11679.                       The way COPY interprets your command line depends on
  11680.                       how many arguments (file, directory, or device names)
  11681.                       are on the line, and whether the arguments are
  11682.                       separated with [+] signs or spaces.
  11683.  
  11684.                       If there is only one argument on the line, COPY assumes
  11685.                       it is the source, and uses the current drive and
  11686.                       directory as the destination.  For example, the
  11687.                       following command copies all the .DAT files on drive A
  11688.                       to the current directory on drive C:
  11689.  
  11690.                            c:\> copy a:*.dat
  11691.  
  11692.                       If there are two or more arguments on the line and [+]
  11693.                       signs are not used, then COPY assumes that the last
  11694.                       argument is the destination and copies all source files
  11695.                       to this new location.  If the destination is a drive,
  11696.                       directory, or device name then the source files are
  11697.                       copied individually to the new location.  If the
  11698.                       destination is a file name, the first source file is
  11699.                       copied to the destination, and any additional source
  11700.                       files are then appended to the new destination file.
  11701.  
  11702.                       For example, the first of these commands copies the
  11703.                       .DAT files from the current directory on drive A
  11704.                       individually to C:\MYDIR (which must already exist as a
  11705.                       directory);  the second appends all the .DAT files
  11706.                       together into one large file called C:\DATA (assuming
  11707.                       C:\DATA is not a directory):
  11708.  
  11709.                            c:>\ copy a:*.dat c:\mydir\
  11710.                            c:>\ copy a:*.dat c:\data
  11711.  
  11712.                       When you copy to a directory, if you add a backslash
  11713.                       [\] to the end of the name as shown in the first
  11714.                       example above, COPY will display an error message if
  11715.                       the name does not refer to an existing directory.  You
  11716.                       can use this feature to keep COPY from treating a
  11717.                       mistyped destination directory name as a file name and
  11718.                       attempting to append all your source files to a
  11719.                       destination file, when you really meant to copy them
  11720.                       individually to a destination directory.
  11721.  
  11722.                   ##  A plus [+] tells COPY to append two or more files to a
  11723.                       single destination file.  If you list several source
  11724.                       files separated with [+] and don't specify a
  11725.  
  11726.  
  11727.           ___________________________________________________________________
  11728.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  198
  11729.  
  11730.                                  CHAPTER 8 / COMMAND REFERENCE GUIDE  /  COPY
  11731.           ___________________________________________________________________
  11732.  
  11733.  
  11734.                       destination, COPY will use the name of the first source
  11735.                       file as the destination, and append each subsequent
  11736.                       file to the first file.  In this case the destination
  11737.                       file will always be created in the current directory,
  11738.                       even if the first source file is in another directory
  11739.                       or on another drive.  For example, the following
  11740.                       command will append the contents of MEMO2 and MEMO3 to
  11741.                       MEMO1 and leave the combined contents in the file
  11742.                       MEMO1:
  11743.  
  11744.                            c:\> copy memo1+memo2+memo3
  11745.  
  11746.                       TO append MEMO2 and MEMO3 from C:\ to D:\MEMO1, and
  11747.                       leave the result in C:\MEMO1:
  11748.  
  11749.                            c:\> copy d:memo1+memo2+memo3
  11750.  
  11751.                       To append the same three files but store the result in
  11752.                       BIGMEMO:
  11753.  
  11754.                            c:\> copy memo1+memo2+memo3 bigmemo
  11755.  
  11756.                   ##  You cannot append files to a device (such as a
  11757.                       printer);  if you try to do so, COPY will ignore the
  11758.                       [+] signs and copy the files individually.  If you
  11759.                       attempt to append several source files to a destination
  11760.                       directory or disk, COPY will append the files and place
  11761.                       the copy in the new location with the same name as the
  11762.                       first source file.
  11763.  
  11764.                   ##  If your destination has wildcards in it, COPY will
  11765.                       attempt to match them with the source names.  For
  11766.                       example, this command copies the .DAT files from drive
  11767.                       A to C:\MYDIR and gives the new copies the extension
  11768.                       .DX:
  11769.  
  11770.                            c:\> copy a:*.dat c:\mydir\*.dx
  11771.  
  11772.                       This feature can give you unexpected results if you use
  11773.                       it with multiple source file names.  For example,
  11774.                       suppose that drive A contains XYZ.DAT and XYZ.TXT.  The
  11775.                       command
  11776.  
  11777.                            c:\> copy a:\*.dat a:\*.txt c:\mydir\*.dx
  11778.  
  11779.                       will copy A:XYZ.DAT to C:\MYDIR\XYZ.DX.  Then it will
  11780.                       copy A:XYZ.TXT to C:\MYDIR\XYZ.DX, overwriting the
  11781.                       first file it copied.
  11782.  
  11783.  
  11784.           ___________________________________________________________________
  11785.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  199
  11786.  
  11787.                                  CHAPTER 8 / COMMAND REFERENCE GUIDE  /  COPY
  11788.           ___________________________________________________________________
  11789.  
  11790.  
  11791.                   ##  COPY also understands include lists (see page 74), so
  11792.                       you can specify several different kinds of files in the
  11793.                       same command.  This command copies the .TXT, .DOC, and
  11794.                       .BAT files from the E:\MYDIR directory to the root
  11795.                       directory of drive A:
  11796.  
  11797.                            c:\> copy e:\mydir\*.txt;*.doc;*.bat a:\
  11798.  
  11799.                   ##  COPY does not change a file's attributes.  The
  11800.                       destination file will have the same attributes as the
  11801.                       source file.
  11802.  
  11803.                   ##  If you are using 4DOS in an OS/2 DOS session, COPY will
  11804.                       copy OS/2 extended attributes from the source to the
  11805.                       destination, provided the the file system on the
  11806.                       destination drive supports them.  You can disable this
  11807.                       feature with the CopyEA = No directive in 4DOS.INI (see
  11808.                       page 138).
  11809.  
  11810.           Options:    The /A(SCII) and /B(inary) options apply to the
  11811.                       preceding filename and to all subsequent filenames on
  11812.                       the command line until another /A or /B is entered.
  11813.                       The other options (/C, /H, /M, /N, /P, /Q, /R, /S, /U,
  11814.                       /V) apply to all filenames on the command line, no
  11815.                       matter where you put them.  For example, either of the
  11816.                       following commands could be used to copy a font file to
  11817.                       the printer in binary mode:
  11818.  
  11819.                            c:\> copy /b myfont.dat prn
  11820.                            c:\> copy myfont.dat /b prn
  11821.  
  11822.                       Some options do not make sense in certain contexts, in
  11823.                       which case COPY will ignore them.  For example, you
  11824.                       cannot prompt before replacing an existing file when
  11825.                       the destination is a device such as the printer --
  11826.                       there's no such thing as an "existing file" on the
  11827.                       printer.  If you use conflicting output options, like
  11828.                       /Q and /P, 4DOS will take a "conservative" approach and
  11829.                       give priority to the option which generates more
  11830.                       prompts or more information.
  11831.  
  11832.                       Options used in less common situations have been marked
  11833.                       with ## below.  Remember that the options are in
  11834.                       alphabetical order, so more basic options are
  11835.                       interspersed with those marked with## .
  11836.  
  11837.                   ##  /A(SCII):  If you use /A with a source filename, 4DOS
  11838.                       will copy the file up to, but not including, the first
  11839.  
  11840.  
  11841.           ___________________________________________________________________
  11842.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  200
  11843.  
  11844.                                  CHAPTER 8 / COMMAND REFERENCE GUIDE  /  COPY
  11845.           ___________________________________________________________________
  11846.  
  11847.  
  11848.                       Ctrl-Z (Control-Z or ASCII 26) character in the file.
  11849.                       If you use /A with a destination filename, 4DOS will
  11850.                       add a Ctrl-Z to the end of the file (some application
  11851.                       programs use the Ctrl-Z to mark the end of a file).
  11852.                       4DOS defaults to /A when appending files.
  11853.  
  11854.                   ##  /B(inary):  If you use /B with a source filename, 4DOS
  11855.                       will copy the entire file.  Using /B with a destination
  11856.                       filename prevents 4DOS from adding a Ctrl-Z to the end
  11857.                       of the destination file.  4DOS defaults to /B for
  11858.                       normal file copies.
  11859.  
  11860.                       /C(hanged files):  Copy files only if the destination
  11861.                       file exists and is older than the source (see also /U).
  11862.                       This option is useful for updating the files in one
  11863.                       directory from those in another without copying any
  11864.                       newly created files.
  11865.  
  11866.                   ##  /H(idden):  Copy all matching files including those
  11867.                       with the hidden and/or system attribute set (see
  11868.                       ATTRIB).
  11869.  
  11870.                       /M(odified):  Copy only those files with the archive
  11871.                       bit set (see ATTRIB), i.e. those which have been
  11872.                       modified since the last backup.  The archive bit will
  11873.                       NOT be cleared after copying.
  11874.  
  11875.                   ##  /N(othing):  Do everything except actually perform the
  11876.                       copy.  This option is most useful for testing what the
  11877.                       result of a complex COPY command will be.
  11878.  
  11879.                       /P(rompt):  Ask the user to confirm each source file by
  11880.                       pressing Y or N.  An N response will skip that
  11881.                       particular file and continue with the rest of the
  11882.                       command.
  11883.  
  11884.                       /Q(uiet):  Turn off the display of the files copied.
  11885.                       This option is most often used in batch files.
  11886.  
  11887.                       /R(eplace):  Prompt the user before overwriting an
  11888.                       existing file.
  11889.  
  11890.                       /S(ubdirectories):  Copy the subdirectory tree starting
  11891.                       with the files in the source directory plus each
  11892.                       subdirectory below that.  The destination must be a
  11893.                       directory;  if it doesn't exist, COPY will attempt to
  11894.                       create it.  COPY will also attempt to create needed
  11895.  
  11896.  
  11897.  
  11898.           ___________________________________________________________________
  11899.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  201
  11900.  
  11901.                                  CHAPTER 8 / COMMAND REFERENCE GUIDE  /  COPY
  11902.           ___________________________________________________________________
  11903.  
  11904.  
  11905.                       subdirectories on the tree below the destination,
  11906.                       including empty source directories.
  11907.  
  11908.                       /U(pdate):  Copy each source file only if it is newer
  11909.                       than a matching destination file or if a matching
  11910.                       destination file does not exist (see also /C).  This
  11911.                       option is useful for keeping one directory matched with
  11912.                       another with a minimum of copying.
  11913.  
  11914.                   ##  /V(erify):  Verify each disk write.  This is the same
  11915.                       as executing the VERIFY ON command, but is only active
  11916.                       during the COPY.  /V does not read back the file and
  11917.                       compare its contents with what was written;  it only
  11918.                       verifies that the data written to disk is physically
  11919.                       readable.
  11920.  
  11921.  
  11922.  
  11923.  
  11924.  
  11925.  
  11926.  
  11927.  
  11928.  
  11929.  
  11930.  
  11931.  
  11932.  
  11933.  
  11934.  
  11935.  
  11936.  
  11937.  
  11938.  
  11939.  
  11940.  
  11941.  
  11942.  
  11943.  
  11944.  
  11945.  
  11946.  
  11947.  
  11948.  
  11949.  
  11950.  
  11951.  
  11952.  
  11953.  
  11954.  
  11955.           ___________________________________________________________________
  11956.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  202
  11957.  
  11958.                                  CHAPTER 8 / COMMAND REFERENCE GUIDE  /  CTTY
  11959.           ___________________________________________________________________
  11960.  
  11961.  
  11962.           CTTY                                                   (Compatible)
  11963.  
  11964.           Purpose:    Change the default console device.
  11965.  
  11966.           Format:     CTTY device
  11967.  
  11968.                       device:  The new console device.
  11969.  
  11970.           ## Usage:   Normally, 4DOS uses the keyboard as the standard input
  11971.                       device and the display as the standard output device.
  11972.                       Together, the keyboard and display are known as the
  11973.                       console or CON.  The CTTY command allows you to
  11974.                       substitute another device that can perform standard
  11975.                       character I/O for the console.
  11976.  
  11977.                       For example to change the console to the first serial
  11978.                       port:
  11979.  
  11980.                            c:\> ctty com1
  11981.  
  11982.                       Change the console back to the standard keyboard and
  11983.                       display:
  11984.  
  11985.                            c:\> ctty con
  11986.  
  11987.                       CTTY works only for programs and commands that use
  11988.                       standard DOS input and output functions.  This includes
  11989.                       all 4DOS internal commands except DRAWBOX, DRAWHLINE,
  11990.                       DRAWVLINE, LIST, SCREEN, SCRPUT, SELECT, and VSCRPUT.
  11991.  
  11992.  
  11993.  
  11994.  
  11995.  
  11996.  
  11997.  
  11998.  
  11999.  
  12000.  
  12001.  
  12002.  
  12003.  
  12004.  
  12005.  
  12006.  
  12007.  
  12008.  
  12009.  
  12010.  
  12011.  
  12012.           ___________________________________________________________________
  12013.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  203
  12014.  
  12015.                                  CHAPTER 8 / COMMAND REFERENCE GUIDE  /  DATE
  12016.           ___________________________________________________________________
  12017.  
  12018.  
  12019.           DATE                                                   (Compatible)
  12020.  
  12021.           Purpose:    Display and optionally change the system date.
  12022.  
  12023.           Format:     DATE [mm-dd-yy]
  12024.  
  12025.                       mm:  The month (01 - 12)
  12026.                       dd:  The day  (01 - 31)
  12027.                       yy:  The year (80 - 199 = 1980 to 2099)
  12028.  
  12029.                       See also: TIME.
  12030.  
  12031.           Usage:      If you simply type DATE without any parameters, 4DOS
  12032.                       will display the current system date and time, and
  12033.                       prompt you for a new date.  Press ENTER if you don't
  12034.                       wish to change the date.  If you type a new date, it
  12035.                       will become the current system date, which is included
  12036.                       in the directory entry of each file as it is created or
  12037.                       altered:
  12038.  
  12039.                            c:\> date
  12040.                            Mon  Sep 16, 1991  9:30:06
  12041.                            Enter new date (mm-dd-yy):
  12042.  
  12043.                       You can also enter a new system date by typing the DATE
  12044.                       command plus the new date on the command line:
  12045.  
  12046.                            c:\> date 9/16/91
  12047.  
  12048.                       You can use hyphens, slashes, or periods to separate
  12049.                       the month, day, and year entries.  A full 4-digit year
  12050.                       can be entered if you wish.
  12051.  
  12052.                       The format for the date entry depends on the country
  12053.                       code defined in the CONFIG.SYS file or by the CHCP
  12054.                       command.  The default format is U.S. (mm-dd-yy).  The
  12055.                       European format is dd-mm-yy; the Japanese is yy-mm-dd.
  12056.  
  12057.  
  12058.  
  12059.  
  12060.  
  12061.  
  12062.  
  12063.  
  12064.  
  12065.  
  12066.  
  12067.  
  12068.  
  12069.           ___________________________________________________________________
  12070.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  204
  12071.  
  12072.                           CHAPTER 8 / COMMAND REFERENCE GUIDE  /  DEL / ERASE
  12073.           ___________________________________________________________________
  12074.  
  12075.  
  12076.           DEL / ERASE                                              (Enhanced)
  12077.  
  12078.           Purpose:    Erase one file, a group of files, or entire
  12079.                       subdirectories.
  12080.  
  12081.           Format:     DEL [/N /P /Q /S /X /Y /Z] file...
  12082.                            or
  12083.                       ERASE [/N /P /Q /S /X /Y /Z] file...
  12084.  
  12085.                       file:  The file, subdirectory, or list of files or
  12086.                       subdirectories to erase.
  12087.  
  12088.                       /N(othing)          /X (remove empty subdirectories)
  12089.                       /P(rompt)           /Y(es to all prompts)
  12090.                       /Q(uiet)            /Z(ap hidden and read-only files)
  12091.                       /S(ubdirectories)
  12092.  
  12093.           Usage:      DEL and ERASE are synonyms, you can use either one.
  12094.  
  12095.                       Use the DEL and ERASE commands with caution; the files
  12096.                       and subdirectories that you erase may be impossible to
  12097.                       recover without specialized utilities and a lot of
  12098.                       work.
  12099.  
  12100.                       To erase a single file, simply enter the file name:
  12101.  
  12102.                            c:\> del letters.txt
  12103.  
  12104.                       Like all 4DOS file processing commands, DEL accepts
  12105.                       multiple file names, wildcards (see page 71), and
  12106.                       include lists (see page 74).  For example, to erase all
  12107.                       the files in the current directory with a .BAK or .PRN
  12108.                       extension:
  12109.  
  12110.                            c:\> del *.bak *.prn
  12111.  
  12112.                       If you enter a subdirectory name, or a filename
  12113.                       composed only of wildcards (* and/or ?), DEL asks for
  12114.                       confirmation (Y or N) unless you specified the /Y
  12115.                       option.  If you respond with a Y, DEL will delete all
  12116.                       the files in that subdirectory (except hidden, system,
  12117.                       and read-only files, unless you have used the /Z
  12118.                       option).
  12119.  
  12120.                   ##  DEL returns a non-zero exit code if no files are
  12121.                       deleted.  You can test this exit code with the %_?
  12122.                       environment variable (see page 81), and use it with
  12123.                       conditional commands (&& and ||; see page 91).
  12124.  
  12125.  
  12126.           ___________________________________________________________________
  12127.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  205
  12128.  
  12129.                           CHAPTER 8 / COMMAND REFERENCE GUIDE  /  DEL / ERASE
  12130.           ___________________________________________________________________
  12131.  
  12132.  
  12133.           Options:##  /N(othing):  Do everything except actually delete the
  12134.                       file(s).  This is useful for testing what the result of
  12135.                       a DEL would be.
  12136.  
  12137.                       /P(rompt):  Ask the user to confirm each erasure by
  12138.                       pressing Y or N.  An N response will skip that
  12139.                       particular erasure.
  12140.  
  12141.                       /Q(uiet):  Don't display filenames as they are deleted.
  12142.                       DEL will run fastest if you specify the /Q option and
  12143.                       the filename doesn't use the extended 4DOS wildcards.
  12144.  
  12145.                       /S(ubdirectories):  Delete the specified files in this
  12146.                       directory and all of its subdirectories.  This is like
  12147.                       a GLOBAL DEL, and can be used to delete all the files
  12148.                       in a subdirectory tree or even a whole disk.  It should
  12149.                       be used with caution!
  12150.  
  12151.                   ##  /X (remove empty subdirectories):  Remove empty
  12152.                       subdirectories after deleting (only useful when used
  12153.                       with /S).
  12154.  
  12155.                  ! ## /Y(es):  The reverse of /P -- it assumes a Y response
  12156.                       to everything, including deleting an entire
  12157.                       subdirectory tree.  4DOS normally prompts before
  12158.                       deleting files when the name consists only of wildcards
  12159.                       or a subdirectory name (see above); /Y overrides this
  12160.                       protection, and should be used with extreme caution!
  12161.  
  12162.                  ! ## /Z(ap):  Delete read-only, hidden, and system files as
  12163.                       well as normal files.  Files with the read-only,
  12164.                       hidden, or system attribute set are normally protected
  12165.                       from deletion; /Z overrides this protection, and should
  12166.                       be used with extreme caution.  Because EXCEPT works by
  12167.                       hiding files, /Z will override an EXCEPT command.
  12168.  
  12169.                       For example, to delete the entire subdirectory tree
  12170.                       starting with C:\UTIL, including hidden and read-only
  12171.                       files, without prompting (use this command with
  12172.                       CAUTION!):
  12173.  
  12174.                            c:\> del /s/x/y/z c:\util\
  12175.  
  12176.  
  12177.  
  12178.  
  12179.  
  12180.  
  12181.  
  12182.  
  12183.           ___________________________________________________________________
  12184.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  206
  12185.  
  12186.                                 CHAPTER 8 / COMMAND REFERENCE GUIDE  /  DELAY
  12187.           ___________________________________________________________________
  12188.  
  12189.  
  12190.           DELAY                                                         (New)
  12191.  
  12192.           Purpose:    Pause for a specified length of time.
  12193.  
  12194.           Format:     DELAY [seconds]
  12195.  
  12196.                       seconds: the number of seconds to delay.
  12197.  
  12198.           Usage:      DELAY is useful in batch file loops while waiting for
  12199.                       something to occur.  To wait for 10 seconds:
  12200.  
  12201.                            delay 10
  12202.  
  12203.                       A simple loop could make a tone with the BEEP command
  12204.                       to get the operator's attention and then DELAY for 60
  12205.                       seconds while it waits for the user to respond.
  12206.  
  12207.                   ##  For delays shorter than one second, use the BEEP
  12208.                       command with an inaudible frequency (below 20 Hz).
  12209.  
  12210.                       You can cancel a delay by pressing Ctrl-C or Ctrl-
  12211.                       Break.
  12212.  
  12213.  
  12214.  
  12215.  
  12216.  
  12217.  
  12218.  
  12219.  
  12220.  
  12221.  
  12222.  
  12223.  
  12224.  
  12225.  
  12226.  
  12227.  
  12228.  
  12229.  
  12230.  
  12231.  
  12232.  
  12233.  
  12234.  
  12235.  
  12236.  
  12237.  
  12238.  
  12239.  
  12240.           ___________________________________________________________________
  12241.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  207
  12242.  
  12243.                              CHAPTER 8 / COMMAND REFERENCE GUIDE  /  DESCRIBE
  12244.           ___________________________________________________________________
  12245.  
  12246.  
  12247.           DESCRIBE                                                      (New)
  12248.  
  12249.           Purpose:    Create, modify, or delete file and subdirectory
  12250.                       descriptions.
  12251.  
  12252.           Format:     DESCRIBE file ["description"] ...
  12253.  
  12254.                       file:  The file or files to operate on.
  12255.                       "description":  The description to attach to the file.
  12256.  
  12257.           Usage:      DESCRIBE adds descriptions to DOS files and
  12258.                       subdirectories.  The descriptions are displayed by DIR
  12259.                       in single-column mode and by SELECT.  Descriptions let
  12260.                       you identify your files in much more meaningful ways
  12261.                       than DOS allows in an eight-character filename.
  12262.  
  12263.                       You enter a description on the command line by typing
  12264.                       the DESCRIBE command, the filename, and the description
  12265.                       in quotation marks, like this:
  12266.  
  12267.                            c:\> describe memo.txt "Memo to Bob about party"
  12268.  
  12269.                       If you don't put a description on the command line,
  12270.                       DESCRIBE will prompt you for it:
  12271.  
  12272.                            c:\> describe memo.txt
  12273.                            Describe "memo.txt" : Memo to Bob about party
  12274.  
  12275.                       If you use wildcards or multiple filenames with the
  12276.                       DESCRIBE command and don't include the description
  12277.                       text, you will be prompted to enter a description for
  12278.                       each file.  If you do include the description on the
  12279.                       command line, all matching files will be given the same
  12280.                       description.
  12281.  
  12282.                       Each description can be up to 40 characters long.  You
  12283.                       can change this limit with the DescriptionMax directive
  12284.                       in 4DOS.INI (see page 208).  DESCRIBE can edit
  12285.                       descriptions longer than DescriptionMax (up to a limit
  12286.                       of 120 characters), but will not allow you to lengthen
  12287.                       the existing text.
  12288.  
  12289.                       4DOS stores the descriptions in each directory in a
  12290.                       hidden file called DESCRIPT.ION.  Use the ATTRIB
  12291.                       command to "unhide" this file if you need to copy or
  12292.                       delete it.
  12293.  
  12294.  
  12295.  
  12296.  
  12297.           ___________________________________________________________________
  12298.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  208
  12299.  
  12300.                              CHAPTER 8 / COMMAND REFERENCE GUIDE  /  DESCRIBE
  12301.           ___________________________________________________________________
  12302.  
  12303.  
  12304.                       The description file is modified appropriately whenever
  12305.                       you perform an internal command which affects it (such
  12306.                       as COPY, MOVE, DEL, or RENAME), but not if you use an
  12307.                       external program (such as XCOPY) or a visual shell.
  12308.  
  12309.  
  12310.  
  12311.  
  12312.  
  12313.  
  12314.  
  12315.  
  12316.  
  12317.  
  12318.  
  12319.  
  12320.  
  12321.  
  12322.  
  12323.  
  12324.  
  12325.  
  12326.  
  12327.  
  12328.  
  12329.  
  12330.  
  12331.  
  12332.  
  12333.  
  12334.  
  12335.  
  12336.  
  12337.  
  12338.  
  12339.  
  12340.  
  12341.  
  12342.  
  12343.  
  12344.  
  12345.  
  12346.  
  12347.  
  12348.  
  12349.  
  12350.  
  12351.  
  12352.  
  12353.  
  12354.           ___________________________________________________________________
  12355.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  209
  12356.  
  12357.                                   CHAPTER 8 / COMMAND REFERENCE GUIDE  /  DIR
  12358.           ___________________________________________________________________
  12359.  
  12360.  
  12361.           DIR                                                      (Enhanced)
  12362.  
  12363.           Purpose:    Display information about files and subdirectories.
  12364.  
  12365.           Format:     DIR [/1 /2 /4 /A[[:][-]rhsda] /B /C[H] /D /E /F /J /K
  12366.                            /L /M /N /O[[:][-]adeginrsu] /P /S /T /U /V /W]
  12367.                            [file...]
  12368.  
  12369.                       file:  The file, directory, or list of files or
  12370.                       directories to display.
  12371.  
  12372.                       /1  (one column)            /L(ower case)
  12373.                       /2  (two columns)           /M  (suppress footer)
  12374.                       /4  (four columns)          /N  (reset DIR options)
  12375.                       /A(ttribute select)         /O  (sort order )
  12376.                       /B(are)                     /P(ause)
  12377.                       /C[H](compression ratios)   /S(ubdirectories)
  12378.                       /D(isable colorization)     /T  (aTtribute display)
  12379.                       /E (upper case)             /U  (sUmmary information)
  12380.                       /F(ull path)                /V(ertical sort)
  12381.                       /J(ustify names)            /W(ide)
  12382.                       /K  (suppress header)
  12383.  
  12384.                       See also: ATTRIB, DESCRIBE, SELECT, and SETDOS.
  12385.  
  12386.           Usage:      DIR can be used to display information about files from
  12387.                       one or more of your disk directories, in a wide range
  12388.                       of formats.  Depending on the options chosen, you can
  12389.                       display the file name, attributes, and size; the time
  12390.                       and date of the last change to the file; and the file
  12391.                       description.  You can also display information in 1, 2,
  12392.                       4, or 5 columns, sort the files several different ways,
  12393.                       use color to distinguish file types, and pause after
  12394.                       each full screen.
  12395.  
  12396.                       The various DIR displays are controlled through options
  12397.                       or switches.  The best way to learn how to use the many
  12398.                       options available with the DIR command is to
  12399.                       experiment.  You will soon know which options you want
  12400.                       to use regularly.  You can select those options
  12401.                       permanently by using the ALIAS command.  You may want
  12402.                       to mix several options.  For example, to display all
  12403.                       the files in the current directory, in 2 columns,
  12404.                       sorted vertically (down one column then down the next),
  12405.                       and with a pause at the end of each page:
  12406.  
  12407.                            c:\> dir /2/p/v
  12408.  
  12409.  
  12410.  
  12411.           ___________________________________________________________________
  12412.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  210
  12413.  
  12414.                                   CHAPTER 8 / COMMAND REFERENCE GUIDE  /  DIR
  12415.           ___________________________________________________________________
  12416.  
  12417.  
  12418.                       To set up this format as the default, using an alias:
  12419.  
  12420.                            c:\> alias dir=`*dir /2/p/v`
  12421.  
  12422.                       This example displays all the files on all directories
  12423.                       of drive C, including hidden and system files, pausing
  12424.                       after each page:
  12425.  
  12426.                            c:\> dir /s/a/p c:\
  12427.  
  12428.                       DIR allows wildcard characters (* and ?) in the
  12429.                       filename.  If you don't specify a filename, DIR
  12430.                       defaults to *.* (display all non-hidden files and
  12431.                       subdirectories in the current directory).  To display
  12432.                       all of the .WKS files in the current directory:
  12433.  
  12434.                            c:\> dir *.wks
  12435.  
  12436.                       If you link two or more filenames together with spaces,
  12437.                       DIR will display all of the files that match the first
  12438.                       name and then all of the files that match the second
  12439.                       name.  You may use a different drive and path for each
  12440.                       filename.  This example lists all of the .WKS and then
  12441.                       all of the .WK1 files in the current directory:
  12442.  
  12443.                            c:\> dir *.wks *.wk1
  12444.  
  12445.                       If you link multiple filenames with a semi-colon [;]
  12446.                       (an "include list", see page 74), DIR will display the
  12447.                       matching filenames in a single listing.  Only the first
  12448.                       filename in an include list can have a path; the other
  12449.                       files must be in the same path.  This example displays
  12450.                       the same files as the previous example, but the .WKS
  12451.                       and .WK1 files are intermixed:
  12452.  
  12453.                            c:\> dir *.wks;*.wk1
  12454.  
  12455.                       If you have an ANSI driver loaded, you can display the
  12456.                       file and subdirectory names in color by setting the
  12457.                       COLORDIR environment variable.  The format for COLORDIR
  12458.                       is:
  12459.  
  12460.                            ext ... :[BRIght][BLInk] fg [ON [BRIght] bg]; ...
  12461.  
  12462.                       where "ext" is a file extension (1 to 3 characters) or
  12463.                       one of the following file types:
  12464.  
  12465.                            DIRS - directories
  12466.  
  12467.  
  12468.           ___________________________________________________________________
  12469.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  211
  12470.  
  12471.                                   CHAPTER 8 / COMMAND REFERENCE GUIDE  /  DIR
  12472.           ___________________________________________________________________
  12473.  
  12474.  
  12475.                            RDONLY - read-only files
  12476.                            HIDDEN - hidden files
  12477.                            SYSTEM - system files
  12478.                            ARCHIVE - files modified since the last backup
  12479.  
  12480.                       For example, to display the .COM and .EXE files in red,
  12481.                       the .C and .ASM files in bright cyan, and the read-only
  12482.                       files in blinking green (this should be entered on one
  12483.                       line):
  12484.  
  12485.                            c:\> set colordir=com exe:red; c asm:bright cyan;
  12486.                                 rdonly:blink green
  12487.  
  12488.                       If you don't specify a background color, DIR will use
  12489.                       the current screen background color.  COLORDIR will not
  12490.                       work properly unless you have an ANSI driver loaded.
  12491.                       Bright backgrounds will not work unless BrightBG is set
  12492.                       to Yes in 4DOS.INI (see page 129).
  12493.  
  12494.                       If you have COLORDIR set and attempt to redirect the
  12495.                       output of DIR to a character device, such as a serial
  12496.                       port or the printer, non-colorized file names will be
  12497.                       displayed on the device but colorized names will still
  12498.                       be displayed on the screen.  This will not occur if the
  12499.                       output of DIR is redirected to a disk file.  To avoid
  12500.                       this problem, use the /D switch to disable directory
  12501.                       colorization when redirecting the output of DIR to a
  12502.                       character device.
  12503.  
  12504.                       When displaying file descriptions, DIR adds a right
  12505.                       arrow at the end of the line if the description is too
  12506.                       long to fit on the screen.  This symbol will alert you
  12507.                       to the existence of additional description text.
  12508.  
  12509.                       DIR can display and sort by file compression ratios on
  12510.                       MS-DOS 6.0 DBLSPACE drives.  Use the /C or /CH switch
  12511.                       to display compression ratios in place of file
  12512.                       descriptions in single-column directory displays.  Use
  12513.                       /O:c to sort the display by compression ratio.  If /O:c
  12514.                       is used in a single-column display, compression ratios
  12515.                       will be displayed automatically (whether or not /C or
  12516.                       /CH is specified).
  12517.  
  12518.                   ##  Extended wildcards (for example "BA[KXC]" for .BAK,
  12519.                       .BAX, and .BAC files) can be used in directory color
  12520.                       specifications.  See page 71 for more information on
  12521.                       extended wildcards.
  12522.  
  12523.  
  12524.  
  12525.           ___________________________________________________________________
  12526.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  212
  12527.  
  12528.                                   CHAPTER 8 / COMMAND REFERENCE GUIDE  /  DIR
  12529.           ___________________________________________________________________
  12530.  
  12531.  
  12532.                   ##  When sorting file names and extensions, 4DOS normally
  12533.                       assumes that sequences of digits should be sorted
  12534.                       numerically (for example, the file DRAW2 would come
  12535.                       before DRAW03 because 2 is numerically larger than 03),
  12536.                       rather than strictly alphabetically (where DRAW2 would
  12537.                       come second because "2" is more than "0").  You can
  12538.                       defeat this behavior and force a strict alphabetic sort
  12539.                       with the /O:a option.
  12540.  
  12541.                   ##  If a country code was defined in the CONFIG.SYS file or
  12542.                       by the CHCP command, DIR will display the date in the
  12543.                       format for that country.  The default date format is
  12544.                       U.S. (mm-dd-yy).  The separator character in the file
  12545.                       time will also be affected by the country code.
  12546.  
  12547.                   ##  DIR can handle directories of any size, limited only by
  12548.                       available memory.  Each filename requires 32 bytes of
  12549.                       free base memory plus the size of the description (if
  12550.                       any); a system with 128K of free base memory can
  12551.                       display up to 4,000 files per directory.
  12552.  
  12553.                   ##  Options on the command line apply only to the filenames
  12554.                       which follow the option, and options at the end of the
  12555.                       line apply to the preceding filename only.  This allows
  12556.                       you to specify different options for different groups
  12557.                       of files, yet retains compatibility with the
  12558.                       traditional DIR command when a single filename is
  12559.                       specified.
  12560.  
  12561.           Options:    /1:  Single column display -- display the filename,
  12562.                       size, date, time, and description.  This is the
  12563.                       default.
  12564.  
  12565.                       /2:  Two column display -- display the filename, size,
  12566.                       date, and time.
  12567.  
  12568.                       /4:  Four column display -- display the filename and
  12569.                       size, in K (kilobytes) or M (megabytes).
  12570.  
  12571.                   ##  /A(ttribute select): Display only those files that have
  12572.                       the specified attribute(s) set.  Preceding the
  12573.                       attribute character with a hyphen [-] will display
  12574.                       those files that DON'T have that attribute set.  The
  12575.                       attributes are:
  12576.  
  12577.                            R    Read-only         D    Subdirectory
  12578.                            H    Hidden            A    Archive
  12579.                            S    System
  12580.  
  12581.  
  12582.           ___________________________________________________________________
  12583.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  213
  12584.  
  12585.                                   CHAPTER 8 / COMMAND REFERENCE GUIDE  /  DIR
  12586.           ___________________________________________________________________
  12587.  
  12588.  
  12589.                       If no attributes are listed at all (e.g. DIR /A), DIR
  12590.                       will display all files and subdirectories including
  12591.                       hidden and system files.  If attributes are combined,
  12592.                       all the specified attributes must match for a file to
  12593.                       be included in the listing.  For example, /A:RHS will
  12594.                       display only those files with all three attributes set.
  12595.                       See page 182 for more information on file attributes.
  12596.  
  12597.                   ##  /B(are):  Suppress the header and summary lines, and
  12598.                       display file or subdirectory names only, in a single
  12599.                       column.  This option is most useful when you want to
  12600.                       redirect a list of names to a file or another program.
  12601.  
  12602.                       /C(ompression ratios):  Display per-file and total
  12603.                       compression ratios on drives compressed with MS-DOS
  12604.                       6.0's DBLSPACE disk compression utility.  The
  12605.                       compression ratio is displayed instead of the file
  12606.                       description.  The ratio is left blank for directories
  12607.                       and files with length 0, and for files on non-DBLSPACE
  12608.                       drives.  /C only works in single-column mode, and is
  12609.                       ignored if /2, /4, or /W is used.
  12610.  
  12611.                       The numerator for the displayed compression ratio is
  12612.                       the amount of space which would be allocated to the
  12613.                       file on the DBLSPACE drive if it were not compressed,
  12614.                       using the DBLSPACE drive's cluster size (normally 8K
  12615.                       bytes).  The denominator is the space actually
  12616.                       allocated to the file after compression.
  12617.  
  12618.                       /CH:  Display compression ratios like /C, but base the
  12619.                       calculation on the host drive's cluster size.  This
  12620.                       gives a more accurate picture of the space saved
  12621.                       through compression than is given by /C.  Please note
  12622.                       that /CH will occasionally display compression ratios
  12623.                       slightly less than 1.0 to 1.0.  This reflects files
  12624.                       which have actually expanded when stored on the
  12625.                       DBLSPACE drive.  COMMAND.COM may display these ratios
  12626.                       as 1.0 to 1.0, even if the true ratio is slightly less.
  12627.                       4DOS always displays the true ratio.
  12628.  
  12629.                   ##  /D(isable colorization):  Temporarily disable directory
  12630.                       colorization.  Required when COLORDIR is set and DIR
  12631.                       output is redirected to a character device like the
  12632.                       printer (e.g. PRN or LPT1) or serial port (e.g. COM1 or
  12633.                       COM2).
  12634.  
  12635.  
  12636.  
  12637.  
  12638.  
  12639.           ___________________________________________________________________
  12640.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  214
  12641.  
  12642.                                   CHAPTER 8 / COMMAND REFERENCE GUIDE  /  DIR
  12643.           ___________________________________________________________________
  12644.  
  12645.  
  12646.                       /E(upper case):  Display filenames in the traditional
  12647.                       upper case; also see SETDOS /U (page 305) and the
  12648.                       UpperCase directive in 4DOS.INI (page 132).
  12649.  
  12650.                   ##  /F(ull path):  Display each filename with its drive
  12651.                       letter and path in a single column, without other
  12652.                       information.
  12653.  
  12654.                       /J(ustify):  Justify (align) filename extensions and
  12655.                       display them in the traditional format.
  12656.  
  12657.                   ##  /K:  Suppress the header (disk and directory name)
  12658.                       display.
  12659.  
  12660.                       /L(ower case):  Display filenames in lower case; also
  12661.                       see SETDOS /U (page 305) and the UpperCase directive in
  12662.                       4DOS.INI (page 132).
  12663.  
  12664.                   ##  /M:  Suppress the footer (file and byte count total)
  12665.                       display.
  12666.  
  12667.                       /N:  Reset the DIR options to the default values.  This
  12668.                       is useful when you want to display some files in one
  12669.                       format, and then change back to the defaults for
  12670.                       another set of files.
  12671.  
  12672.                       /O(rder):  Set the sorting order.  You may use any
  12673.                       combination of the following sorting options; if
  12674.                       multiple options are used the listing will be sorted
  12675.                       with the first sort option as the primary key, the next
  12676.                       as the secondary key, and so on:
  12677.  
  12678.                            -    Reverse the sort order for the next option
  12679.                            a    Sort names and extensions in standard ASCII
  12680.                                 order, rather than sorting numerically when
  12681.                                 digits are included in the name or extension
  12682.                            c    Sort by DBLSPACE compression ratio; also
  12683.                                 implies /C
  12684.                            d    Sort by date and time (oldest first)
  12685.                            e    Sort by extension
  12686.                            g    Group subdirectories together
  12687.                            i    Sort by the file description
  12688.                            n    Sort by filename (this is the default)
  12689.                            r    Reverse the sort order for all options
  12690.                            s    Sort by size
  12691.                            u    Unsorted
  12692.  
  12693.  
  12694.  
  12695.  
  12696.           ___________________________________________________________________
  12697.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  215
  12698.  
  12699.                                   CHAPTER 8 / COMMAND REFERENCE GUIDE  /  DIR
  12700.           ___________________________________________________________________
  12701.  
  12702.  
  12703.                       /P(ause):  Wait for a key to be pressed after each
  12704.                       screen page before continuing the display.
  12705.  
  12706.                       /S(ubdirectories):  Display file information from the
  12707.                       current directory and all of its subdirectories.  DIR
  12708.                       will only display headers and summaries for those
  12709.                       directories with files that match the filename(s) and
  12710.                       attributes (if /A is used) that you specify on the
  12711.                       command line.
  12712.  
  12713.                   ##  /T  (aTtributes):  Display the filenames and attributes
  12714.                       only.  The attributes are displayed in the format RHSA,
  12715.                       where:
  12716.  
  12717.                            R    Read-only
  12718.                            H    Hidden
  12719.                            S    System
  12720.                            A    Archive
  12721.  
  12722.                       /U (sUmmary information):  Only display the number of
  12723.                       files, the total file size, and the total amount of
  12724.                       disk space used.
  12725.  
  12726.                       /V(ertical sort):  Display the filenames sorted
  12727.                       vertically rather than horizontally (used with the /2,
  12728.                       /4 or /W options).
  12729.  
  12730.                       /W(ide):  Display filenames only, horizontally across
  12731.                       the screen (5 columns on an 80-character wide display).
  12732.  
  12733.  
  12734.  
  12735.  
  12736.  
  12737.  
  12738.  
  12739.  
  12740.  
  12741.  
  12742.  
  12743.  
  12744.  
  12745.  
  12746.  
  12747.  
  12748.  
  12749.  
  12750.  
  12751.  
  12752.  
  12753.           ___________________________________________________________________
  12754.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  216
  12755.  
  12756.                                  CHAPTER 8 / COMMAND REFERENCE GUIDE  /  DIRS
  12757.           ___________________________________________________________________
  12758.  
  12759.  
  12760.           DIRS                                                          (New)
  12761.  
  12762.           Purpose:    Display the current directory stack.
  12763.  
  12764.           Format:     DIRS
  12765.  
  12766.                       See also: PUSHD and POPD.
  12767.  
  12768.           Usage:      The PUSHD command adds the current default drive and
  12769.                       directory to the directory stack, a list that 4DOS
  12770.                       maintains in memory.  The POPD command removes the top
  12771.                       entry of the directory stack and makes that drive and
  12772.                       directory the new default.  The DIRS command displays
  12773.                       the contents of the directory stack, with the most
  12774.                       recent entries on top (i.e., the next POPD will
  12775.                       retrieve the first entry that DIRS displays).
  12776.  
  12777.                       For example, to change directories and then display the
  12778.                       directory stack:
  12779.  
  12780.                            c:\> pushd c:\database
  12781.                            c:\database> pushd d:\wordp\memos
  12782.                            d:\wordp\memos> dirs
  12783.                            c:\database
  12784.                            c:\
  12785.  
  12786.                       The directory stack holds 255 characters, enough for
  12787.                       about 10 to 20 typical drive and directory entires.
  12788.  
  12789.  
  12790.  
  12791.  
  12792.  
  12793.  
  12794.  
  12795.  
  12796.  
  12797.  
  12798.  
  12799.  
  12800.  
  12801.  
  12802.  
  12803.  
  12804.  
  12805.  
  12806.  
  12807.  
  12808.  
  12809.  
  12810.           ___________________________________________________________________
  12811.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  217
  12812.  
  12813.                               CHAPTER 8 / COMMAND REFERENCE GUIDE  /  DRAWBOX
  12814.           ___________________________________________________________________
  12815.  
  12816.  
  12817.           DRAWBOX                                                       (New)
  12818.  
  12819.           Purpose:    Draw a box on the screen.
  12820.  
  12821.           Format:     DRAWBOX ulrow ulcol lrrow lrcol style [BRIght] [BLInk]
  12822.                            fg ON [BRIght] bg [FILl bgfill] [SHAdow]
  12823.  
  12824.                       ulrow:  Row for upper left corner
  12825.                       ulcol:  Column for upper left corner
  12826.                       lrrow:  Row for lower right corner
  12827.                       lrcol:  Column for lower right corner
  12828.                       style:  Box drawing style:
  12829.                            0    No lines (box is drawn with blanks)
  12830.                            1    Single line
  12831.                            2    Double line
  12832.                            3    Single on top and bottom, double on sides
  12833.                            4    Double on top and bottom, single on sides
  12834.                       fg:  Foreground character color
  12835.                       bg:  Background character color
  12836.                       bgfill:  Background fill color (for the inside of the
  12837.                       box)
  12838.  
  12839.                       The available colors are:
  12840.  
  12841.                         Black         Blue          Green         Red
  12842.                         Magenta       Cyan          Yellow        White
  12843.  
  12844.                       See also: DRAWHLINE and DRAWVLINE.
  12845.  
  12846.           Usage:      DRAWBOX is useful for creating attractive screen
  12847.                       displays in batch files.  DRAWBOX detects other lines
  12848.                       and boxes on the display, and creates the appropriate
  12849.                       connector characters when possible (not all types of
  12850.                       lines can be connected with the available characters).
  12851.  
  12852.                       For example, to draw a box around the entire screen
  12853.                       with bright white lines on a blue background (enter
  12854.                       this on one line):
  12855.  
  12856.                            drawbox 0 0 24 79 1 bri whi on blu fill blu
  12857.  
  12858.                       Only the first three characters of the color name and
  12859.                       the keywords BRIGHT, BLINK, FILL, and SHADOW are
  12860.                       required.  Bright backgrounds will not work unless
  12861.                       BrightBG is set to Yes in 4DOS.INI (see page 129).
  12862.  
  12863.                       If you use SHADOW, a drop shadow is created by changing
  12864.                       the characters in the row under the box and the 2
  12865.  
  12866.  
  12867.           ___________________________________________________________________
  12868.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  218
  12869.  
  12870.                               CHAPTER 8 / COMMAND REFERENCE GUIDE  /  DRAWBOX
  12871.           ___________________________________________________________________
  12872.  
  12873.  
  12874.                       columns to the right of the box to normal intensity
  12875.                       text with a black background (this will make characters
  12876.                       displayed in black disappear entirely).
  12877.  
  12878.                       The row and column values are zero-based, so on a
  12879.                       standard 25 line by 80 column display, valid rows are 0
  12880.                       - 24 and valid columns are 0 - 79.
  12881.  
  12882.                       DRAWBOX checks for valid row and column values, and
  12883.                       displays a "Usage" error message if any values are out
  12884.                       of range.
  12885.  
  12886.  
  12887.  
  12888.  
  12889.  
  12890.  
  12891.  
  12892.  
  12893.  
  12894.  
  12895.  
  12896.  
  12897.  
  12898.  
  12899.  
  12900.  
  12901.  
  12902.  
  12903.  
  12904.  
  12905.  
  12906.  
  12907.  
  12908.  
  12909.  
  12910.  
  12911.  
  12912.  
  12913.  
  12914.  
  12915.  
  12916.  
  12917.  
  12918.  
  12919.  
  12920.  
  12921.  
  12922.  
  12923.  
  12924.           ___________________________________________________________________
  12925.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  219
  12926.  
  12927.                             CHAPTER 8 / COMMAND REFERENCE GUIDE  /  DRAWHLINE
  12928.           ___________________________________________________________________
  12929.  
  12930.  
  12931.           DRAWHLINE                                                     (New)
  12932.  
  12933.           Purpose:    Draw a horizontal line on the screen.
  12934.  
  12935.           Format:     DRAWHLINE row column len style [BRIght] [BLInk]
  12936.                            fg ON [BRIght] bg
  12937.  
  12938.                       row:  Starting row
  12939.                       column:  Starting column
  12940.                       len:  Length of line
  12941.                       style:  Line drawing style:
  12942.                            1    Single line
  12943.                            2    Double line
  12944.                       fg:  Foreground character color
  12945.                       bg:  Background character color
  12946.  
  12947.                       The available colors are:
  12948.  
  12949.                         Black         Blue          Green         Red
  12950.                         Magenta       Cyan          Yellow        White
  12951.  
  12952.                       See also: DRAWBOX and DRAWVLINE.
  12953.  
  12954.           Usage:      DRAWHLINE is useful for creating attractive screen
  12955.                       displays in batch files.  It detects other lines and
  12956.                       boxes on the display, and creates the appropriate
  12957.                       connector characters when possible (not all types of
  12958.                       lines can be connected with the available characters).
  12959.  
  12960.                       For example, the following command draws a double line
  12961.                       along the top row of the display with green characters
  12962.                       on a blue background:
  12963.  
  12964.                            drawhline 0 0 80 2 green on blue
  12965.  
  12966.                       Only the first three characters of the color name and
  12967.                       the attributes BRIGHT and BLINK are required.  Bright
  12968.                       backgrounds will not work unless BrightBG is set to Yes
  12969.                       in 4DOS.INI (see page 129).
  12970.  
  12971.                       The row and column values are zero-based, so on a
  12972.                       standard 25 line by 80 column display, valid rows are 0
  12973.                       - 24 and valid columns are 0 - 79.
  12974.  
  12975.                       DRAWHLINE checks for a valid row and column, and
  12976.                       displays a "Usage" error message if either value is out
  12977.                       of range.
  12978.  
  12979.  
  12980.  
  12981.           ___________________________________________________________________
  12982.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  220
  12983.  
  12984.                             CHAPTER 8 / COMMAND REFERENCE GUIDE  /  DRAWVLINE
  12985.           ___________________________________________________________________
  12986.  
  12987.  
  12988.           DRAWVLINE                                                     (New)
  12989.  
  12990.           Purpose:    Draw a vertical line on the screen.
  12991.  
  12992.           Format:     DRAWVLINE row column len style [BRIght][BLInk]
  12993.                            fg ON [BRIght] bg
  12994.  
  12995.                       row:  Starting row
  12996.                       column:  Starting column
  12997.                       len:  Length of line
  12998.                       style:  Line drawing style:
  12999.                            1    Single line
  13000.                            2    Double line
  13001.                       fg:  Foreground character color
  13002.                       bg:  Background character color
  13003.  
  13004.                       The available colors are:
  13005.  
  13006.                         Black         Blue          Green         Red
  13007.                         Magenta       Cyan          Yellow        White
  13008.  
  13009.                       See also: DRAWBOX and DRAWHLINE.
  13010.  
  13011.           Usage:      DRAWVLINE is useful for creating attractive screen
  13012.                       displays in batch files.  It detects other lines and
  13013.                       boxes on the display, and creates the appropriate
  13014.                       connector characters when possible (not all types of
  13015.                       lines can be connected with the available characters).
  13016.  
  13017.                       For example, to draw a double width line along the left
  13018.                       margin of the display with bright red characters on a
  13019.                       black background:
  13020.  
  13021.                            drawvline 0 0 25 2 bright red on black
  13022.  
  13023.                       Only the first three characters of the color name and
  13024.                       the attributes BRIGHT and BLINK are required.  Bright
  13025.                       backgrounds will not work unless BrightBG is set to Yes
  13026.                       in 4DOS.INI (see page 129).
  13027.  
  13028.                       The row and column values are zero-based, so on a
  13029.                       standard 25 line by 80 column display, valid rows are 0
  13030.                       - 24 and valid columns are 0 - 79.
  13031.  
  13032.                       DRAWVLINE checks for a valid row and column, and
  13033.                       displays a "Usage" error message if either value is out
  13034.                       of range.
  13035.  
  13036.  
  13037.  
  13038.           ___________________________________________________________________
  13039.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  221
  13040.  
  13041.                                  CHAPTER 8 / COMMAND REFERENCE GUIDE  /  ECHO
  13042.           ___________________________________________________________________
  13043.  
  13044.  
  13045.           ECHO                                                     (Enhanced)
  13046.  
  13047.           Purpose:    Display a message, enable or disable batch file or
  13048.                       command line echoing, or display the echo status.
  13049.  
  13050.           Format:     ECHO [ON | OFF | message]
  13051.  
  13052.                       message:  Text to display.
  13053.  
  13054.                       See also: ECHOS, SCREEN, SCRPUT, SETDOS and TEXT.
  13055.  
  13056.           Usage:      4DOS has a separate echo capability for batch files and
  13057.                       for the command line.
  13058.  
  13059.                       In a batch file, if you turn ECHO on, each line of the
  13060.                       file is displayed before it is executed.  If you turn
  13061.                       ECHO off, each line is executed without being
  13062.                       displayed.  ECHO can also be used in a batch file to
  13063.                       display a message on the screen.  Regardless of the
  13064.                       ECHO state, a batch file line that begins with the [@]
  13065.                       character will not be displayed.  To turn off batch
  13066.                       file echoing, without displaying the ECHO command, use
  13067.                       this line:
  13068.  
  13069.                            @echo off
  13070.  
  13071.                       ECHO commands in a batch file will send messages to the
  13072.                       screen while the batch file executes, even if ECHO is
  13073.                       set OFF.  For example, this line will display a message
  13074.                       in a batch file:
  13075.  
  13076.                            echo Processing your print files...
  13077.  
  13078.                       If you want to echo a blank line from within a batch
  13079.                       file, enter:
  13080.  
  13081.                            echo.
  13082.  
  13083.                       You cannot use the command separator character [^] or
  13084.                       the 4DOS redirection symbols (| > <) in an ECHO
  13085.                       message, unless you enclose them in quotes or precede
  13086.                       them with the escape character (see page 94).
  13087.  
  13088.                       4DOS defaults to ECHO ON in batch files.  The current
  13089.                       ECHO state is inherited by called batch files.  You can
  13090.                       change the default setting to ECHO OFF with the SETDOS
  13091.                       /V0 command or the BatchEcho directive in 4DOS.INI (see
  13092.                       page 129).
  13093.  
  13094.  
  13095.           ___________________________________________________________________
  13096.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  222
  13097.  
  13098.                                  CHAPTER 8 / COMMAND REFERENCE GUIDE  /  ECHO
  13099.           ___________________________________________________________________
  13100.  
  13101.  
  13102.                       If you turn the command line ECHO on, 4DOS will display
  13103.                       each command before it is executed.  This will let you
  13104.                       see the command line after 4DOS has expanded all
  13105.                       aliases and variables.  The command line ECHO is most
  13106.                       useful when you are learning how to use the advanced
  13107.                       features of 4DOS.  This example will turn command line
  13108.                       echoing on:
  13109.  
  13110.                            c:\> echo on
  13111.  
  13112.                       4DOS defaults to ECHO OFF during keyboard input.  The
  13113.                       keyboard ECHO state is independent of the batch file
  13114.                       ECHO state;  changing ECHO in a batch file has no
  13115.                       effect on the display at the command prompt, and vice
  13116.                       versa.
  13117.  
  13118.                       To see the current echo state, use the ECHO command
  13119.                       with no arguments.  This displays either the batch file
  13120.                       or command line echo state, depending on where the ECHO
  13121.                       command is performed.
  13122.  
  13123.  
  13124.  
  13125.  
  13126.  
  13127.  
  13128.  
  13129.  
  13130.  
  13131.  
  13132.  
  13133.  
  13134.  
  13135.  
  13136.  
  13137.  
  13138.  
  13139.  
  13140.  
  13141.  
  13142.  
  13143.  
  13144.  
  13145.  
  13146.  
  13147.  
  13148.  
  13149.  
  13150.  
  13151.  
  13152.           ___________________________________________________________________
  13153.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  223
  13154.  
  13155.                                 CHAPTER 8 / COMMAND REFERENCE GUIDE  /  ECHOS
  13156.           ___________________________________________________________________
  13157.  
  13158.  
  13159.           ECHOS                                                         (New)
  13160.  
  13161.           Purpose:    Display a message without a trailing carriage return
  13162.                       and line feed.
  13163.  
  13164.           Format:     ECHOS message
  13165.  
  13166.                       See also: ECHO, SCREEN, SCRPUT, TEXT, and VSCRPUT.
  13167.  
  13168.           Usage:      ECHOS is useful for outputting text when you don't want
  13169.                       4DOS to add a carriage return / linefeed pair.  For
  13170.                       example, you can use ECHOS when you need to redirect
  13171.                       control sequences to your printer (the "^X" represents
  13172.                       the 4DOS escape character, which is normally Ctrl-X):
  13173.  
  13174.                            c:\> echos ^XeP > lpt1:
  13175.  
  13176.                       You cannot use the command separator character [^] or
  13177.                       the 4DOS redirection symbols (|><) in an ECHOS message,
  13178.                       unless you enclose them in quotes or preceded them with
  13179.                       the escape character (see page 94).
  13180.  
  13181.                   ##  ECHOS does not translate or modify the message text.
  13182.                       For example, carriage return characters are not
  13183.                       translated to CR/LF pairs.  ECHOS sends only the
  13184.                       characters you enter (after 4DOS escape character and
  13185.                       back-quote processing as described above).  The only
  13186.                       character you cannot put into an ECHOS message is the
  13187.                       NUL character (ASCII 0).
  13188.  
  13189.  
  13190.  
  13191.  
  13192.  
  13193.  
  13194.  
  13195.  
  13196.  
  13197.  
  13198.  
  13199.  
  13200.  
  13201.  
  13202.  
  13203.  
  13204.  
  13205.  
  13206.  
  13207.  
  13208.  
  13209.           ___________________________________________________________________
  13210.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  224
  13211.  
  13212.                              CHAPTER 8 / COMMAND REFERENCE GUIDE  /  ENDLOCAL
  13213.           ___________________________________________________________________
  13214.  
  13215.  
  13216.           ENDLOCAL                                                      (New)
  13217.  
  13218.           Purpose:    Restore the saved disk drive, directory, environment,
  13219.                       and alias list.
  13220.  
  13221.           Format:     ENDLOCAL
  13222.  
  13223.                       See also: SETLOCAL.
  13224.  
  13225.           ## Usage:   The SETLOCAL command in a batch file saves the current
  13226.                       disk drive, default directory, all environment
  13227.                       variables, and the alias list.  ENDLOCAL restores
  13228.                       everything that was saved by the previous SETLOCAL
  13229.                       command.
  13230.  
  13231.                       For example, this batch file fragment saves the drive,
  13232.                       current working directory, and environment variables,
  13233.                       changes the drive and directory, sets some environment
  13234.                       variables, runs the program TEST1, and then restores
  13235.                       the original values:
  13236.  
  13237.                            setlocal
  13238.                            cdd d:\test
  13239.                            set path=c:\;c:\dos;c:\util
  13240.                            set lib=d:\lib
  13241.                            test1
  13242.                            endlocal
  13243.  
  13244.                       SETLOCAL and ENDLOCAL can only be used in batch files,
  13245.                       not in aliases or from the command line.
  13246.  
  13247.  
  13248.  
  13249.  
  13250.  
  13251.  
  13252.  
  13253.  
  13254.  
  13255.  
  13256.  
  13257.  
  13258.  
  13259.  
  13260.  
  13261.  
  13262.  
  13263.  
  13264.  
  13265.  
  13266.           ___________________________________________________________________
  13267.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  225
  13268.  
  13269.                                  CHAPTER 8 / COMMAND REFERENCE GUIDE  /  ESET
  13270.           ___________________________________________________________________
  13271.  
  13272.  
  13273.           ESET                                                          (New)
  13274.  
  13275.           Purpose:    Edit environment variables and aliases.
  13276.  
  13277.           Format:     ESET [/M] variable name...
  13278.  
  13279.                       variable name:  The name of an environment variable or
  13280.                       alias to edit.
  13281.  
  13282.                       /M(aster environment)
  13283.  
  13284.                       See also: ALIAS, UNALIAS, SET, and UNSET.
  13285.  
  13286.           Usage:      ESET allows you to edit environment variables and
  13287.                       aliases using the 4DOS line editing commands (see page
  13288.                       55).
  13289.  
  13290.                       For example, to edit the executable file search path:
  13291.  
  13292.                            c:\> eset path
  13293.                            path=c:\;c:\dos;c:\util
  13294.  
  13295.                       To create and then edit an alias:
  13296.  
  13297.                            c:\> alias d dir /d/j/p
  13298.                            c:\> eset d
  13299.                            d=dir /d/j/p
  13300.  
  13301.                       ESET will search for environment variables first and
  13302.                       then aliases.  If you have an environment variable and
  13303.                       an alias with the same name, ESET will only be able to
  13304.                       edit the environment variable.
  13305.  
  13306.                       4DOS limits environment variable and alias names to 80
  13307.                       characters, and their arguments to 255 characters.
  13308.  
  13309.           Option: ##  /M(aster environment): Edit an environment variable in
  13310.                       the master environment rather than the local
  13311.                       environment.  This option is only useful from a
  13312.                       secondary command shell (for example, when an
  13313.                       application has "shelled to DOS").  /M only works for
  13314.                       environment variables; it cannot be used to edit the
  13315.                       primary shell's aliases.
  13316.  
  13317.  
  13318.  
  13319.  
  13320.  
  13321.  
  13322.  
  13323.           ___________________________________________________________________
  13324.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  226
  13325.  
  13326.                                CHAPTER 8 / COMMAND REFERENCE GUIDE  /  EXCEPT
  13327.           ___________________________________________________________________
  13328.  
  13329.  
  13330.           EXCEPT                                                        (New)
  13331.  
  13332.           Purpose:    Perform a command on all available files except those
  13333.                       specified.
  13334.  
  13335.           Format:     EXCEPT (file) command
  13336.  
  13337.                       file:  The file or files to exclude from the command.
  13338.                       command:  The command to execute, including all
  13339.                       appropriate arguments and switches.
  13340.  
  13341.                       See also: ATTRIB.
  13342.  
  13343.           Usage:      EXCEPT provides a means of executing a command on a
  13344.                       group of files and/or subdirectories, and excluding a
  13345.                       subgroup from the operation.  The command can be a 4DOS
  13346.                       internal command or alias, an external command, or a
  13347.                       batch file.
  13348.  
  13349.                       You may use wildcards to specify the files to exclude
  13350.                       from the command.  The first example erases all the
  13351.                       files in the current directory except those beginning
  13352.                       with MEMO and those ending in .WKS.  The second example
  13353.                       copies all the files and subdirectories on drive C to
  13354.                       drive D except those in C:\MSC and C:\DOS, using the
  13355.                       COPY command:
  13356.  
  13357.                            c:\> except (memo*.* *.wks) erase *.*
  13358.                            c:\> except (c:\msc c:\dos) copy c:\*.* d:\ /s
  13359.  
  13360.                   ##  If you use EXCEPT with filename completion (see page
  13361.                       59) to get the filenames inside the parentheses, type a
  13362.                       space after the open parenthesis before entering a
  13363.                       partial filename or pressing Tab.  Otherwise, the
  13364.                       command line editor will treat the open parenthesis as
  13365.                       the first character of the filename to be completed.
  13366.  
  13367.                   ##  EXCEPT prevents operations on the specified file(s) by
  13368.                       setting the hidden attribute, performing the command,
  13369.                       and then clearing the hidden attribute.  If the command
  13370.                       is aborted in an unusual way, you may need to use the
  13371.                       ATTRIB command to "unhide" (-H) the file(s).
  13372.  
  13373.                   ##  EXCEPT will not work with programs or commands that
  13374.                       ignore the hidden attribute or which work explicitly
  13375.                       with hidden files, including DEL /Z and the /H (process
  13376.                       hidden files) switch available in some 4DOS file
  13377.                       processing commands.
  13378.  
  13379.  
  13380.           ___________________________________________________________________
  13381.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  227
  13382.  
  13383.                                CHAPTER 8 / COMMAND REFERENCE GUIDE  /  EXCEPT
  13384.           ___________________________________________________________________
  13385.  
  13386.  
  13387.                   ##  You can use command grouping (see page 92) to execute
  13388.                       multiple commands with a single EXCEPT.  For example,
  13389.                       the following command copies all files in the current
  13390.                       directory whose extensions begin with .DA, except the
  13391.                       .DAT files, to the D:\SAVE directory, then changes the
  13392.                       first two characters of the extension of the copied
  13393.                       files to .SA.  This example should be entered on one
  13394.                       line:
  13395.  
  13396.                            c:\data> except (*.dat) (copy *.da* d:\save ^
  13397.                                     ren *.da* *.sa*)
  13398.  
  13399.                   ##  You may need to increase 4DOS's internal stack size
  13400.                       using the StackSize directive in 4DOS.INI if you use
  13401.                       extremely complex combinations of commands like EXCEPT,
  13402.                       FOR, GLOBAL, IF, and SELECT on the same command line,
  13403.                       or use complex combinations of these commands in nested
  13404.                       batch files or nested GOSUBs.  See the StackSize
  13405.                       directive on page 141 for more information.
  13406.  
  13407.  
  13408.  
  13409.  
  13410.  
  13411.  
  13412.  
  13413.  
  13414.  
  13415.  
  13416.  
  13417.  
  13418.  
  13419.  
  13420.  
  13421.  
  13422.  
  13423.  
  13424.  
  13425.  
  13426.  
  13427.  
  13428.  
  13429.  
  13430.  
  13431.  
  13432.  
  13433.  
  13434.  
  13435.  
  13436.  
  13437.           ___________________________________________________________________
  13438.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  228
  13439.  
  13440.                                  CHAPTER 8 / COMMAND REFERENCE GUIDE  /  EXIT
  13441.           ___________________________________________________________________
  13442.  
  13443.  
  13444.           EXIT                                                     (Enhanced)
  13445.  
  13446.           Purpose:    Return from a secondary command processor.
  13447.  
  13448.           Format:     EXIT [value]
  13449.  
  13450.                       value:  The exit code to return (0 - 255).
  13451.  
  13452.           Usage:      Some application programs will start a secondary copy
  13453.                       of the command processor to allow you to execute DOS
  13454.                       commands.  To return to the application again, type:
  13455.  
  13456.                            c:\> exit
  13457.  
  13458.                   ##  If you specify a value, EXIT will return that value to
  13459.                       the program that started 4DOS.  For example:
  13460.  
  13461.                            c:\> exit 255
  13462.  
  13463.                   ##  The value is a number you can use to inform the program
  13464.                       of some result, such as the success or failure of a
  13465.                       batch file.  This feature is most useful for systems
  13466.                       which use batch files to automate their operation, such
  13467.                       as bulletin boards, or custom application programs like
  13468.                       databases that shell to 4DOS to perform certain tasks.
  13469.  
  13470.                   ##  You cannot EXIT from the primary command processor
  13471.                       unless you are running in an OS/2 2.x DOS session.
  13472.  
  13473.  
  13474.  
  13475.  
  13476.  
  13477.  
  13478.  
  13479.  
  13480.  
  13481.  
  13482.  
  13483.  
  13484.  
  13485.  
  13486.  
  13487.  
  13488.  
  13489.  
  13490.  
  13491.  
  13492.  
  13493.  
  13494.           ___________________________________________________________________
  13495.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  229
  13496.  
  13497.                                   CHAPTER 8 / COMMAND REFERENCE GUIDE  /  FOR
  13498.           ___________________________________________________________________
  13499.  
  13500.  
  13501.           FOR                                                      (Enhanced)
  13502.  
  13503.           Purpose:    Repeat a command for several values of a variable.
  13504.  
  13505.           Format:     FOR [/A[[:][-]rhsda]] %var IN ([@]set) [DO] command ...
  13506.  
  13507.                       %var:  The variable to be used in the command ("FOR
  13508.                       variable").
  13509.                       set:  A set of values for the variable.
  13510.                       command:  A command or group of commands to be executed
  13511.                       for each value of the variable.
  13512.  
  13513.                       /A(ttribute select)
  13514.  
  13515.           Usage:      4DOS begins the FOR command by creating a set.  It then
  13516.                       executes a command for every member of the set.  The
  13517.                       command can be a 4DOS internal command or alias, an
  13518.                       external command, or a batch file.
  13519.  
  13520.                       Normally, the set is a list of files specified with
  13521.                       wildcards.  For example, if you use this line in a
  13522.                       batch file:
  13523.  
  13524.                            for %x in (*.txt) do list %x
  13525.  
  13526.                       4DOS will create a list of all files in the current
  13527.                       directory with the extension .TXT.  It sets the FOR
  13528.                       variable %x equal to each of the file names in turn,
  13529.                       and executes the LIST command for each of the files.
  13530.  
  13531.                       The set can include multiple files or an include list,
  13532.                       like this:
  13533.  
  13534.                            for %x in (d:\*.txt;*.doc;*.asc) do type %x
  13535.  
  13536.                       The set can also be made up of text instead of file
  13537.                       names.  For example, to display the free space on
  13538.                       drives C:, D:, and E:, you could use:
  13539.  
  13540.                            for %drive in (c d e) do free %drive:
  13541.  
  13542.                       When the set is made up of text or several separate
  13543.                       file names (not an include list), the elements must be
  13544.                       separated by spaces, tabs, commas, or the switch
  13545.                       character (normally a slash [/]).
  13546.  
  13547.                   ##  You can also set the FOR variable equal to each line in
  13548.                       a file by placing an [@] in front of the file name.  If
  13549.  
  13550.  
  13551.           ___________________________________________________________________
  13552.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  230
  13553.  
  13554.                                   CHAPTER 8 / COMMAND REFERENCE GUIDE  /  FOR
  13555.           ___________________________________________________________________
  13556.  
  13557.  
  13558.                       you have a file called DRIVES.TXT that contains a list
  13559.                       of drives on your computer, one drive name per line
  13560.                       (with a ":" after each drive letter), you can print the
  13561.                       free space on each drive this way:
  13562.  
  13563.                            for %d in (@drives.txt) do free %d > prn
  13564.  
  13565.                   ##  Because the [@] is also a valid filename character, FOR
  13566.                       first checks to see if the file exists with the [@] in
  13567.                       its name (e.g., @DRIVES.TXT).  If so, the filename is
  13568.                       treated as a normal argument.  If it doesn't exist, FOR
  13569.                       uses the filename (without the [@]) as the file from
  13570.                       which to retrieve text.
  13571.  
  13572.                   ##  4DOS will accept either % or %% in front of the
  13573.                       variable name.  You can use either form whether the FOR
  13574.                       command is typed from the command line or is part of an
  13575.                       alias or batch file.  The variable name can be up to 80
  13576.                       characters long.  The word DO is optional.
  13577.  
  13578.                   ##  If you use a single-character FOR variable name 4DOS
  13579.                       will give that name priority over any environment
  13580.                       variable which starts with the same letter, in order to
  13581.                       maintain compatibility with the traditional FOR
  13582.                       command.  For example, the following command tries to
  13583.                       add a: and b: to the end of the PATH, but will not work
  13584.                       as intended:
  13585.  
  13586.                            c:\> for %p in (a: b:) do path %path;%p
  13587.  
  13588.                       The "%p" in "%path" will be interpreted as the FOR
  13589.                       variable %p followed by the text "ath", which is not
  13590.                       what was intended.  To get around this, use a different
  13591.                       letter or a longer name for the FOR variable, or use
  13592.                       square brackets around the variable name (see page 78).
  13593.  
  13594.                   ##  The following example uses FOR with variable functions
  13595.                       to delete the .BAK files for which a corresponding .TXT
  13596.                       file exists in the current directory (this should be
  13597.                       entered on one line):
  13598.  
  13599.                            c:\docs> for %file in (*.txt) do if exist
  13600.                                     %file del %@name[%file].bak
  13601.  
  13602.                   ##  You can use command grouping (see page 92) to execute
  13603.                       multiple commands for each element in the list.  For
  13604.                       example, the following command copies each .WKQ file in
  13605.                       the current directory to the D:\WKSAVE directory, and
  13606.  
  13607.  
  13608.           ___________________________________________________________________
  13609.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  231
  13610.  
  13611.                                   CHAPTER 8 / COMMAND REFERENCE GUIDE  /  FOR
  13612.           ___________________________________________________________________
  13613.  
  13614.  
  13615.                       then changes the extension of each file in the current
  13616.                       directory to .SAV.  This example should be entered on
  13617.                       one line:
  13618.  
  13619.                            c:\text> for %file in (*.wkq) do (copy %file
  13620.                                     d:\wksave\ ^ ren %file *.sav)
  13621.  
  13622.                   ##  In a batch file you can use GOSUB to execute a
  13623.                       subroutine for every element in the set.  Within the
  13624.                       subroutine the FOR variable can be used just like any
  13625.                       environment variable.  This is a convenient way to
  13626.                       execute a complex sequence of commands for every
  13627.                       element in the set without CALLing another batch file.
  13628.  
  13629.                   ##  One unusual use of FOR is to execute a collection of
  13630.                       batch files or other commands with the same parameter.
  13631.                       For example, you might want to have three batch files
  13632.                       all operate on the same data file.  The FOR command
  13633.                       could look like this (this should all be entered on one
  13634.                       line):
  13635.  
  13636.                            c:\> for %x in (filetest fileform fileprnt)
  13637.                                 do %x datafile
  13638.  
  13639.                       4DOS will expand this to three separate commands:
  13640.  
  13641.                            filetest datafile
  13642.                            fileform datafile
  13643.                            fileprnt datafile
  13644.  
  13645.                   ##  The variable that FOR uses (the %X in the example
  13646.                       above) is created in the environment and then erased
  13647.                       when the FOR command is done.  Because of this, you
  13648.                       must be careful not to use the name of one of your
  13649.                       environment variables as a FOR variable.  For example,
  13650.                       a command that begins
  13651.  
  13652.                            c:\> for %path in (...
  13653.  
  13654.                       will write over your current path setting and then
  13655.                       erase the path variable completely.
  13656.  
  13657.                   ##  FOR statements can be nested.  The permissible nesting
  13658.                       level depends on the amount of free space in 4DOS's
  13659.                       internal stack.
  13660.  
  13661.                   ##  You may need to increase 4DOS's internal stack size
  13662.                       using the StackSize directive in 4DOS.INI if you use
  13663.  
  13664.  
  13665.           ___________________________________________________________________
  13666.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  232
  13667.  
  13668.                                   CHAPTER 8 / COMMAND REFERENCE GUIDE  /  FOR
  13669.           ___________________________________________________________________
  13670.  
  13671.  
  13672.                       extremely complex combinations of commands like EXCEPT,
  13673.                       FOR, GLOBAL, IF, and SELECT on the same command line,
  13674.                       or use complex combinations of these commands in nested
  13675.                       batch files or nested GOSUBs.  See the StackSize
  13676.                       directive on page 141 for more information.
  13677.  
  13678.           Options: ## /A(ttribute select): Process only those files that have
  13679.                       the specified attribute(s).  /A will be used only when
  13680.                       processing wildcard file names in the set.  It will be
  13681.                       ignored for filenames without wildcards or other items
  13682.                       in the set.  Preceding the attribute character with a
  13683.                       hyphen [-] will process those files that DON'T have
  13684.                       that attribute set.  The attributes are:
  13685.  
  13686.                            R    Read-only         D    Subdirectory
  13687.                            H    Hidden            A    Archive
  13688.                            S    System
  13689.  
  13690.                       If no attributes are listed at all (e.g. FOR /A ...),
  13691.                       FOR will process all files including hidden and system
  13692.                       files.  If attributes are combined, all the specified
  13693.                       attributes must match for a file to be included.  For
  13694.                       example, /A:RHS will include only those files with all
  13695.                       three attributes set.  See page 182 for more
  13696.                       information on file attributes.
  13697.  
  13698.                       For example, to process only those files with the
  13699.                       archive attribute:
  13700.  
  13701.                            for /a:a %%f in (*.*) echo %%f needs a backup!
  13702.  
  13703.  
  13704.  
  13705.  
  13706.  
  13707.  
  13708.  
  13709.  
  13710.  
  13711.  
  13712.  
  13713.  
  13714.  
  13715.  
  13716.  
  13717.  
  13718.  
  13719.  
  13720.  
  13721.  
  13722.           ___________________________________________________________________
  13723.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  233
  13724.  
  13725.                                  CHAPTER 8 / COMMAND REFERENCE GUIDE  /  FREE
  13726.           ___________________________________________________________________
  13727.  
  13728.  
  13729.           FREE                                                          (New)
  13730.  
  13731.           Purpose:    Display the total disk space, total bytes used, and
  13732.                       total bytes free on the specified (or default)
  13733.                       drive(s).
  13734.  
  13735.           Format:     FREE [drive: ...]
  13736.  
  13737.                       drive:  One or more drives to include in the report.
  13738.  
  13739.                       See also: MEMORY.
  13740.  
  13741.           Usage:      FREE provides the same disk information as the external
  13742.                       DOS command CHKDSK, but without the wait, since it does
  13743.                       not check the integrity of the file and directory
  13744.                       structure of the disk.
  13745.  
  13746.                       A colon [:] is required after each drive letter.  This
  13747.                       example displays the status of drives A and C:
  13748.  
  13749.                            c:\> free a: c:
  13750.                             Volume in drive A: is unlabeled
  13751.                              1,213,952 bytes total disk space
  13752.                              1,115,136 bytes used
  13753.                                 98,816 bytes free
  13754.                             Volume in drive C: is DEVELOPMENT
  13755.                             42,496,000 bytes total disk space
  13756.                             36,851,712 bytes used
  13757.                              5,644,288 bytes free
  13758.  
  13759.                       If you are using DOS 4.0 or later, the disk serial
  13760.                       number will appear after the drive label or name.
  13761.  
  13762.                       Some networks with large server disk drives (256 MB or
  13763.                       more) may report disk space values that are too small
  13764.                       when FREE is used.  If this occurs, it is because the
  13765.                       network software does not provide a way to return
  13766.                       larger values to 4DOS.
  13767.  
  13768.  
  13769.  
  13770.  
  13771.  
  13772.  
  13773.  
  13774.  
  13775.  
  13776.  
  13777.  
  13778.  
  13779.           ___________________________________________________________________
  13780.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  234
  13781.  
  13782.                                CHAPTER 8 / COMMAND REFERENCE GUIDE  /  GLOBAL
  13783.           ___________________________________________________________________
  13784.  
  13785.  
  13786.           GLOBAL                                                        (New)
  13787.  
  13788.           Purpose:    Execute a command in the current directory and its
  13789.                       subdirectories.
  13790.  
  13791.           Format:     GLOBAL [/H /I /Q] command
  13792.  
  13793.                       command:  The command to execute, including arguments
  13794.                       and switches.
  13795.  
  13796.                       /H(idden directories)            /Q(uiet)
  13797.                       /I(gnore exit codes)
  13798.  
  13799.           Usage:      GLOBAL performs the command first in the current
  13800.                       directory and then in every subdirectory under the
  13801.                       current directory.  The command can be a 4DOS internal
  13802.                       command or alias, an external command, or a batch file.
  13803.  
  13804.                       The first example erases all the files with a .BAK
  13805.                       extension in every directory on C.  The second example
  13806.                       copies the files in every directory on drive A to the
  13807.                       directory C:\TEMP:
  13808.  
  13809.                            c:\> global erase *.bak
  13810.                            a:\> global copy *.* c:\temp
  13811.  
  13812.                   ##  You can use command grouping (see page 92) to execute
  13813.                       multiple commands in each subdirectory.  For example,
  13814.                       the following command copies each .TXT file in the
  13815.                       current directory and all of its subdirectories to
  13816.                       drive A.  It then changes the extension of each of the
  13817.                       copied files to .SAV:
  13818.  
  13819.                            c:\> global (copy *.txt a: ^ ren *.txt *.sav)
  13820.  
  13821.                   ##  You may need to increase 4DOS's internal stack size
  13822.                       using the StackSize directive in 4DOS.INI if you use
  13823.                       extremely complex combinations of commands like EXCEPT,
  13824.                       FOR, GLOBAL, IF, and SELECT on the same command line,
  13825.                       or use complex combinations of these commands in nested
  13826.                       batch files or nested GOSUBs.  See the StackSize
  13827.                       directive on page 141 for more information.
  13828.  
  13829.           Options:##  /H(idden directories):  Forces GLOBAL to look for
  13830.                       hidden directories.  If you don't use this switch,
  13831.                       hidden directories are ignored.
  13832.  
  13833.  
  13834.  
  13835.  
  13836.           ___________________________________________________________________
  13837.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  235
  13838.  
  13839.                                CHAPTER 8 / COMMAND REFERENCE GUIDE  /  GLOBAL
  13840.           ___________________________________________________________________
  13841.  
  13842.  
  13843.                   ##  /I(gnore exit codes):  If this option is not specified,
  13844.                       GLOBAL will terminate if the command returns a non-zero
  13845.                       exit code.  Use /I if you want command to continue in
  13846.                       additional subdirectories even if it returns an error
  13847.                       in a previous subdirectory.
  13848.  
  13849.                       /Q(uiet):  Do not display the directory names as each
  13850.                       directory is processed.
  13851.  
  13852.  
  13853.  
  13854.  
  13855.  
  13856.  
  13857.  
  13858.  
  13859.  
  13860.  
  13861.  
  13862.  
  13863.  
  13864.  
  13865.  
  13866.  
  13867.  
  13868.  
  13869.  
  13870.  
  13871.  
  13872.  
  13873.  
  13874.  
  13875.  
  13876.  
  13877.  
  13878.  
  13879.  
  13880.  
  13881.  
  13882.  
  13883.  
  13884.  
  13885.  
  13886.  
  13887.  
  13888.  
  13889.  
  13890.  
  13891.  
  13892.  
  13893.           ___________________________________________________________________
  13894.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  236
  13895.  
  13896.                                 CHAPTER 8 / COMMAND REFERENCE GUIDE  /  GOSUB
  13897.           ___________________________________________________________________
  13898.  
  13899.  
  13900.           GOSUB                                                         (New)
  13901.  
  13902.           Purpose:    Execute a subroutine in the current batch file.
  13903.  
  13904.           Format:     GOSUB label
  13905.  
  13906.                       label:  The batch file line label at the beginning of
  13907.                       the subroutine.
  13908.  
  13909.                       See also: CALL, GOTO and RETURN.
  13910.  
  13911.           ## Usage:   4DOS allows subroutines in batch files.  A subroutine
  13912.                       begins with a label (a colon followed by a word) and
  13913.                       ends with a RETURN command.  The subroutine is invoked
  13914.                       with a GOSUB command from another part of the batch
  13915.                       file.  The RETURN command ends a subroutine; execution
  13916.                       of the batch file will continue with the command
  13917.                       following the original GOSUB.  GOSUB allows you to
  13918.                       create subroutines within a batch file (to call other
  13919.                       batch files, see CALL.)
  13920.  
  13921.                       The subroutine must start with a label that begins with
  13922.                       a colon [:] and which appears on a line by itself.
  13923.                       4DOS ignores case differences when matching labels.
  13924.  
  13925.                       The subroutine must end with a RETURN statement.  After
  13926.                       the RETURN, 4DOS will continue processing the batch
  13927.                       file with the command following the GOSUB command.
  13928.  
  13929.                       The following batch file fragment calls a subroutine
  13930.                       which displays the directory and returns:
  13931.  
  13932.                            echo Calling a subroutine
  13933.                            gosub subr1
  13934.                            echo Returned from the subroutine
  13935.                            quit
  13936.                            :subr1
  13937.                            dir /a/w
  13938.                            return
  13939.  
  13940.                       If the label doesn't exist, the batch file is
  13941.                       terminated with the error message "Label not found."
  13942.  
  13943.                       GOSUB saves the IFF state, so IFF statements inside a
  13944.                       subroutine won't interfere with IFF statements in the
  13945.                       part of the batch file from which the subroutine was
  13946.                       called.
  13947.  
  13948.  
  13949.  
  13950.           ___________________________________________________________________
  13951.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  237
  13952.  
  13953.                                 CHAPTER 8 / COMMAND REFERENCE GUIDE  /  GOSUB
  13954.           ___________________________________________________________________
  13955.  
  13956.  
  13957.                       Subroutines can be nested.  The permissible nesting
  13958.                       level depends on the amount of free space in 4DOS's
  13959.                       internal stack.
  13960.  
  13961.                   ##  You may need to increase 4DOS's internal stack size
  13962.                       using the StackSize directive in 4DOS.INI if you use
  13963.                       extremely complex combinations of commands like EXCEPT,
  13964.                       FOR, GLOBAL, IF, and SELECT on the same command line,
  13965.                       or use complex combinations of these commands in nested
  13966.                       batch files or nested GOSUBs.  See the StackSize
  13967.                       directive on page 141 for more information.
  13968.  
  13969.  
  13970.  
  13971.  
  13972.  
  13973.  
  13974.  
  13975.  
  13976.  
  13977.  
  13978.  
  13979.  
  13980.  
  13981.  
  13982.  
  13983.  
  13984.  
  13985.  
  13986.  
  13987.  
  13988.  
  13989.  
  13990.  
  13991.  
  13992.  
  13993.  
  13994.  
  13995.  
  13996.  
  13997.  
  13998.  
  13999.  
  14000.  
  14001.  
  14002.  
  14003.  
  14004.  
  14005.  
  14006.  
  14007.           ___________________________________________________________________
  14008.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  238
  14009.  
  14010.                                  CHAPTER 8 / COMMAND REFERENCE GUIDE  /  GOTO
  14011.           ___________________________________________________________________
  14012.  
  14013.  
  14014.           GOTO                                                   (Compatible)
  14015.  
  14016.           Purpose:    Branch to a specified line inside the current batch
  14017.                       file.
  14018.  
  14019.           Format:     GOTO [/I] label
  14020.  
  14021.                       label:  The batch file line label to branch to.
  14022.  
  14023.                       /I(FF continues)
  14024.  
  14025.                       See also: GOSUB.
  14026.  
  14027.           Usage:      After a GOTO command in a batch file, the next line to
  14028.                       be executed will be the one immediately after the
  14029.                       label.  The label must begin with a colon [:] and
  14030.                       appear on a line by itself.  4DOS ignores case
  14031.                       differences when matching labels.
  14032.  
  14033.                       This batch file fragment checks for the existence of
  14034.                       the file CONFIG.SYS.  If the file exists, 4DOS jumps to
  14035.                       C_EXISTS and copies all the files from the current
  14036.                       directory to the root directory on A:.  Otherwise, 4DOS
  14037.                       prints an error message and exits.
  14038.  
  14039.                            if exist config.sys goto C_EXISTS
  14040.                            echo CONFIG.SYS doesn't exist - exiting.
  14041.                            quit
  14042.                            :C_EXISTS
  14043.                            copy *.* a:\
  14044.  
  14045.                       If the label doesn't exist, the batch file is
  14046.                       terminated with the error message "Label not found."
  14047.  
  14048.                       To avoid errors in the processing of nested IFF
  14049.                       statements, if /I is not used GOTO cancels all active
  14050.                       IFF statements.  This means that a normal GOTO (without
  14051.                       /I) inside an IFF statement must branch outside all IFF
  14052.                       statements, and  may not branch to any label that is
  14053.                       between an IFF and the corresponding ENDIFF.  This
  14054.                       includes branches inside the current IFF statement.
  14055.  
  14056.           Options:##  /I(FF continues):  Prevents GOTO from cancelling IFF
  14057.                       statements.  Use this option only if you are absolutely
  14058.                       certain that your GOTO command is branching entirely
  14059.                       within the current active IFF statement, and not into
  14060.                       another IFF statement or a different IFF nesting level.
  14061.  
  14062.  
  14063.  
  14064.           ___________________________________________________________________
  14065.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  239
  14066.  
  14067.                                  CHAPTER 8 / COMMAND REFERENCE GUIDE  /  GOTO
  14068.           ___________________________________________________________________
  14069.  
  14070.  
  14071.                       Using /I under any other conditions will cause an error
  14072.                       later in your batch file.
  14073.  
  14074.  
  14075.  
  14076.  
  14077.  
  14078.  
  14079.  
  14080.  
  14081.  
  14082.  
  14083.  
  14084.  
  14085.  
  14086.  
  14087.  
  14088.  
  14089.  
  14090.  
  14091.  
  14092.  
  14093.  
  14094.  
  14095.  
  14096.  
  14097.  
  14098.  
  14099.  
  14100.  
  14101.  
  14102.  
  14103.  
  14104.  
  14105.  
  14106.  
  14107.  
  14108.  
  14109.  
  14110.  
  14111.  
  14112.  
  14113.  
  14114.  
  14115.  
  14116.  
  14117.  
  14118.  
  14119.  
  14120.  
  14121.           ___________________________________________________________________
  14122.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  240
  14123.  
  14124.                                  CHAPTER 8 / COMMAND REFERENCE GUIDE  /  HELP
  14125.           ___________________________________________________________________
  14126.  
  14127.  
  14128.           HELP                                        (New, External command)
  14129.  
  14130.           Purpose:    Display help for 4DOS and DOS commands.
  14131.  
  14132.           Format:     HELP [/M /Sn /X] [topic]
  14133.  
  14134.                       topic:  A help topic, 4DOS internal command, or DOS
  14135.                       external command.
  14136.  
  14137.                       /M(onochrome)               /X (disable mouse)
  14138.                       /Sn (set mouse speed)
  14139.  
  14140.           Usage:      HELP displays a brief description and the proper syntax
  14141.                       of both 4DOS and DOS commands.  If you simply type
  14142.  
  14143.                            c:\> help
  14144.  
  14145.                       you will see a list of all help topics.  You can select
  14146.                       a topic by using the cursor keys and then pressing
  14147.                       Enter.
  14148.  
  14149.                       If you want to avoid the opening list, use a topic or
  14150.                       command name.  For example, if you want help with the
  14151.                       4DOS COPY command, type
  14152.  
  14153.                            c:\> help copy
  14154.  
  14155.                       You can also start HELP by pressing F1 at the 4DOS
  14156.                       prompt (see page 63).
  14157.  
  14158.                       4HELP.EXE must be in the current directory or one of
  14159.                       the directories specified in the current PATH setting.
  14160.                       If you keep the help files in a directory which is not
  14161.                       on your PATH, you must set the full path for the help
  14162.                       program with the HelpPath directive in 4DOS.INI (see
  14163.                       page 126).  If you use the HelpPath directive, the HELP
  14164.                       command will generally respond more quickly, because
  14165.                       4DOS won't have to search the directories in your PATH
  14166.                       setting to find the help files.
  14167.  
  14168.                       The HELPCFG program included with 4DOS allows you to
  14169.                       customize the HELP colors.  To use it, just change to
  14170.                       your 4DOS directory, run HELPCFG, and follow the
  14171.                       instructions it displays.  To force HELPCFG to adjust
  14172.                       the monochrome HELP colors, even when running on a
  14173.                       color system, use the command HELPCFG /M.
  14174.  
  14175.  
  14176.  
  14177.  
  14178.           ___________________________________________________________________
  14179.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  241
  14180.  
  14181.                                  CHAPTER 8 / COMMAND REFERENCE GUIDE  /  HELP
  14182.           ___________________________________________________________________
  14183.  
  14184.  
  14185.                       If you use another program named HELP, you can use two
  14186.                       alias commands to rename the 4DOS help command as
  14187.                       4HELP:
  14188.  
  14189.                            c:\> alias 4help=`*help`
  14190.                            c:\> alias help=`c:\util\help.exe`
  14191.  
  14192.                       You can set options for HELP when your system boots
  14193.                       with the HelpOptions directive in 4DOS.INI (see page
  14194.                       126).
  14195.  
  14196.                       If you want to customize the help text (for example, to
  14197.                       add help for your own commands or aliases), you will
  14198.                       need the 4DOS Utility Disk which contains the source
  14199.                       text and hypertext compiler.
  14200.  
  14201.           Options:    /M(onochrome):  forces HELP to use a monochrome display
  14202.                       mode on color systems.  This is useful on any system
  14203.                       where HELP may be "fooled" into thinking you have a
  14204.                       color display when you don't, including portable
  14205.                       computers with LCD screens.
  14206.  
  14207.                       /Sn (Speed):  sets the HELP mouse movement speed.  /S0
  14208.                       sets the speed to one half the default speed, /S2 sets
  14209.                       it to twice the default, and /S4 sets it to four times
  14210.                       the default.  The larger values may be useful if you
  14211.                       normally use a screen size larger than the standard 80
  14212.                       x 25.
  14213.  
  14214.                       /X (disable mouse):  Completely disables the mouse in
  14215.                       HELP.  If you have a Microsoft serial or PS/2 mouse and
  14216.                       are experiencing long delays when HELP starts, you can
  14217.                       use this option to disable the mouse if you wish.  (The
  14218.                       delay is caused by the extended time required by the
  14219.                       Microsoft Mouse driver to initialize these mice.)
  14220.  
  14221.  
  14222.  
  14223.  
  14224.  
  14225.  
  14226.  
  14227.  
  14228.  
  14229.  
  14230.  
  14231.  
  14232.  
  14233.  
  14234.  
  14235.           ___________________________________________________________________
  14236.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  242
  14237.  
  14238.                               CHAPTER 8 / COMMAND REFERENCE GUIDE  /  HISTORY
  14239.           ___________________________________________________________________
  14240.  
  14241.  
  14242.           HISTORY                                                       (New)
  14243.  
  14244.           Purpose:    Display, add to, clear, or read the history list.
  14245.  
  14246.           Format:     HISTORY [/A command /F /P /R filename]
  14247.  
  14248.                       /A(dd)                      /P(ause)
  14249.                       /F(ree)                     /R(ead)
  14250.  
  14251.                       See also: LOG
  14252.  
  14253.           Usage:      4DOS keeps a list of the commands you have entered on
  14254.                       the command line.  See page 56 for information on
  14255.                       command recall, which allows you to use the history
  14256.                       list to repeat or edit commands you have typed.
  14257.  
  14258.                       The HISTORY command lets you view and manipulate the
  14259.                       command history list directly.  If no parameters are
  14260.                       entered, HISTORY will display the current command
  14261.                       history list:
  14262.  
  14263.                            c:\> history
  14264.  
  14265.                       With the options explained below, you can clear the
  14266.                       list, add new commands to the list without executing
  14267.                       them, save the list in a file, or read a new list from
  14268.                       a file.
  14269.  
  14270.                       The number of commands saved in the history list
  14271.                       depends on the length of each command line.  The
  14272.                       history list size can be specified at startup from 256
  14273.                       to 8192 characters (see page 126).  The default size is
  14274.                       1024 characters.
  14275.  
  14276.                   ##  You can use the HISTORY command as an aid in writing
  14277.                       batch files.  Any time you have executed a series of
  14278.                       commands that you'd like to save as the basis for a
  14279.                       batch file, simply redirect the output of HISTORY to a
  14280.                       file:
  14281.  
  14282.                            c:\> history > newbatch
  14283.  
  14284.                       Then edit the output file to contain only the commands
  14285.                       you want in the batch file, and save it under the
  14286.                       appropriate name.  If you know you're going to use
  14287.                       HISTORY this way, you may want to use the /F switch to
  14288.                       clear the history first, so that your output file isn't
  14289.                       cluttered with too many extraneous commands.
  14290.  
  14291.  
  14292.           ___________________________________________________________________
  14293.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  243
  14294.  
  14295.                               CHAPTER 8 / COMMAND REFERENCE GUIDE  /  HISTORY
  14296.           ___________________________________________________________________
  14297.  
  14298.  
  14299.                   ##  You can disable the history list or specify a minimum
  14300.                       command line length to save with the HistMin directive
  14301.                       in the 4DOS.INI file.
  14302.  
  14303.           Options:##  /A(dd):  Add a command to the history list.  This
  14304.                       performs the same function as the Ctrl-K key at the
  14305.                       command line (see page 56).
  14306.  
  14307.                       /F(ree):  Erase all entries in the command history
  14308.                       list.
  14309.  
  14310.                       /P(rompt):  Wait for a key after displaying each page
  14311.                       of the list.
  14312.  
  14313.                   ##  /R(ead):  Read the command history from the specified
  14314.                       file and append it to the history list currently held
  14315.                       in memory.  You can save the history list by
  14316.                       redirecting the output of HISTORY to a file.  This
  14317.                       example saves the command history to a file called
  14318.                       HISTFLE and reads it back again immediately.  If you
  14319.                       leave out the second line, 4DOS will append the
  14320.                       contents of the file to the current history list
  14321.                       instead of replacing the current history list with the
  14322.                       file copy:
  14323.  
  14324.                            c:\> history > histfile
  14325.                            c:\> history /f
  14326.                            c:\> history /r histfile
  14327.  
  14328.                       If you need to save your history at the end of each
  14329.                       day's work, you might use commands like this in your
  14330.                       AUTOEXEC.BAT file:
  14331.  
  14332.                            if exist c:\histfile history /r c:\histfile
  14333.                            alias shut*down `history > c:\histfile`
  14334.  
  14335.                       This restores the previous history list if it exists,
  14336.                       then defines an alias which will save the history
  14337.                       before shutting off the system.
  14338.  
  14339.  
  14340.  
  14341.  
  14342.  
  14343.  
  14344.  
  14345.  
  14346.  
  14347.  
  14348.  
  14349.           ___________________________________________________________________
  14350.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  244
  14351.  
  14352.                                    CHAPTER 8 / COMMAND REFERENCE GUIDE  /  IF
  14353.           ___________________________________________________________________
  14354.  
  14355.  
  14356.           IF                                                       (Enhanced)
  14357.  
  14358.           Purpose:    Execute a command if a condition or set of conditions
  14359.                       is true.
  14360.  
  14361.           Format:     IF [NOT] condition [.AND. | .OR. | .XOR. [NOT]
  14362.                            condition ...] command
  14363.  
  14364.                       condition:  A test to determine if the command should
  14365.                       be executed.
  14366.                       command:  The command to execute if the condition is
  14367.                       true.
  14368.  
  14369.                       See also: IFF.
  14370.  
  14371.           Usage:      IF is normally used only in aliases and batch files.
  14372.                       It is always followed by one or more conditions and
  14373.                       then a command.  4DOS first evaluates the conditions.
  14374.                       If they are true, 4DOS executes the command.
  14375.                       Otherwise, the command is ignored.  If you add a NOT
  14376.                       before a condition, the command is executed only when
  14377.                       the condition is false.
  14378.  
  14379.                       You can link conditions with .AND., .OR., or .XOR., and
  14380.                       you can nest IF statements.  The conditions can test
  14381.                       strings, numbers, the existence of a file or
  14382.                       subdirectory, the errorlevel returned from the
  14383.                       preceding external command, and the existence of alias
  14384.                       names and internal commands.
  14385.  
  14386.                       The command can be an alias, a 4DOS internal command,
  14387.                       an external command, or a batch file.  The entire IF
  14388.                       statement, including all conditions and the command,
  14389.                       must fit on one line.
  14390.  
  14391.                   ##  You can use command grouping (see page 92) to execute
  14392.                       multiple commands if the condition is true.  For
  14393.                       example, the following command tests if any .TXT files
  14394.                       exist.  If they do, they are copied to drive A: and
  14395.                       their extensions are changed to .TXO:
  14396.  
  14397.                            if exist *.txt (copy *.txt a: ^ ren *.txt *.txo)
  14398.  
  14399.                       (The IFF command provides a more structured method of
  14400.                       executing multiple commands if a condition or set of
  14401.                       conditions is true.)
  14402.  
  14403.  
  14404.  
  14405.  
  14406.           ___________________________________________________________________
  14407.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  245
  14408.  
  14409.                                    CHAPTER 8 / COMMAND REFERENCE GUIDE  /  IF
  14410.           ___________________________________________________________________
  14411.  
  14412.  
  14413.                   ##  You may need to increase 4DOS's internal stack size
  14414.                       using the StackSize directive in 4DOS.INI if you use
  14415.                       extremely complex combinations of commands like EXCEPT,
  14416.                       FOR, GLOBAL, IF, and SELECT on the same command line,
  14417.                       or use complex combinations of these commands in nested
  14418.                       batch files or nested GOSUBs.  See the StackSize
  14419.                       directive on page 141 for more information.
  14420.  
  14421.           Conditions: The following conditional tests are available in both
  14422.                       the IF and IFF commands.  They fit into three
  14423.                       categories: string tests, numeric tests, and system
  14424.                       tests.  The tests can use environment variables, 4DOS
  14425.                       internal-variables and variable functions (see pages 81
  14426.                       and 85), file names, and literal text and values as
  14427.                       their arguments.
  14428.  
  14429.                       Spaces are required on either side of the condition in
  14430.                       all cases except ==, which will work with or without
  14431.                       spaces around it.
  14432.  
  14433.                       If you use one of the string or numeric tests like ==
  14434.                       or GE, 4DOS decides whether to compare the values as
  14435.                       numbers or as strings by examining the first character
  14436.                       of each value.  If both values begin with a digit, 4DOS
  14437.                       performs a numeric comparison.  If either value does
  14438.                       not begin with a digit, a string comparison is done.
  14439.                       To force a string comparison, use double quotes around
  14440.                       the values you are testing.
  14441.  
  14442.                       The difference between numeric and string comparisons
  14443.                       is best explained by looking at the way values with and
  14444.                       without blanks are tested.  For example, consider
  14445.                       comparing the values 2 and 19.  Numerically, 2 is
  14446.                       smaller, but as a string it is "larger" because its
  14447.                       first digit is larger than the first digit of 19.  So
  14448.                       the first of these conditions will be true, and the
  14449.                       second will be false:
  14450.  
  14451.                            if 2 lt 19 ...
  14452.                            if "2" lt "19" ...
  14453.  
  14454.                       String Tests:
  14455.  
  14456.                         For the string tests, 4DOS ignores case differences.
  14457.                         When you compare strings, you should always enclose
  14458.                         the arguments in double quotes in order to avoid
  14459.                         syntax errors which may occur if one of the argument
  14460.                         values is empty.
  14461.  
  14462.  
  14463.           ___________________________________________________________________
  14464.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  246
  14465.  
  14466.                                    CHAPTER 8 / COMMAND REFERENCE GUIDE  /  IF
  14467.           ___________________________________________________________________
  14468.  
  14469.  
  14470.                         string1 == string2
  14471.  
  14472.                         string1 EQ string2
  14473.  
  14474.                            If string1 is equal to string2, then the
  14475.                            condition is true.
  14476.  
  14477.                         string1 != string2
  14478.                         string1 NE string2
  14479.  
  14480.                            If string1 is not equal to string 2, then the
  14481.                            condition is true.
  14482.  
  14483.                         string1 LT string2
  14484.  
  14485.                            If string1 is less than string2, then the
  14486.                            condition is true.
  14487.  
  14488.                         string1 LE string2
  14489.  
  14490.                            If string1 is less than or equal to string2, then
  14491.                            the condition is true.
  14492.  
  14493.                         string1 GT string2
  14494.  
  14495.                            If string1 is greater than string2, then the
  14496.                            condition is true.
  14497.  
  14498.                         string1 GE string2
  14499.  
  14500.                            If string1 is greater than or equal to string2,
  14501.                            then the condition is true.
  14502.  
  14503.                         This first batch file fragment runs a program called
  14504.                         MONOPROG if a monochrome monitor is attached to the
  14505.                         system:
  14506.  
  14507.                                 if "%_monitor" == "mono" monoprog
  14508.  
  14509.                         The second batch file fragment tests for a string
  14510.                         value:
  14511.  
  14512.                                 input "Enter your selection : " %%cmd
  14513.                                 if "%cmd" == "WP" goto wordproc
  14514.                                 if "%cmd" NE "GRAPHICS" goto badentry
  14515.  
  14516.  
  14517.  
  14518.  
  14519.  
  14520.           ___________________________________________________________________
  14521.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  247
  14522.  
  14523.                                    CHAPTER 8 / COMMAND REFERENCE GUIDE  /  IF
  14524.           ___________________________________________________________________
  14525.  
  14526.  
  14527.                         This example calls GO.BTM if the first two
  14528.                         characters of the file MYFILE contain the string
  14529.                         "GO" (enter this example on one line):
  14530.  
  14531.                                 if "%@substr[%@line[myfile,0],0,2]"=="GO"
  14532.                                 call go.btm
  14533.  
  14534.                       Numeric Tests:
  14535.  
  14536.                         The numeric tests available are exactly the same as
  14537.                         the string tests (==, EQ, !=, NE, LT, LE, GT, and
  14538.                         GE), but compare values as numbers instead of
  14539.                         strings.  Both values must begin with a digit or
  14540.                         4DOS will perform a string test instead.
  14541.  
  14542.                         The first example below tests whether there is more
  14543.                         than 500 KBytes of free base memory; the second
  14544.                         tests for  more than 2 MBytes of free EMS memory:
  14545.  
  14546.                               c:\> if %@dosmem[k] gt 500 echo Over 500K free
  14547.                               c:\> if %@ems[m] gt 2 echo Over 2 MB EMS free
  14548.  
  14549.                         This example shows how to implement a simple loop
  14550.                         inside a batch file.  The lines between the labels
  14551.                         :loop and :loopdone will be executed 100 times:
  14552.  
  14553.                                 set limit=100
  14554.                                 set counter=1
  14555.                                 :loop
  14556.                                 if %counter gt %limit goto loopdone
  14557.                                   rem DO SOME WORK HERE
  14558.                                   set counter=%@eval[%counter + 1]
  14559.                                   goto loop
  14560.                                 :loopdone
  14561.  
  14562.                       System Tests:
  14563.  
  14564.                         The final conditions test the system status.  You
  14565.                         can also use 4DOS pseudo-variables and variable
  14566.                         functions to test other parts of the system status.
  14567.  
  14568.                         ERRORLEVEL [condition] n
  14569.  
  14570.                            This test retrieves the exit code of the
  14571.                            preceding external program.  By convention,
  14572.                            programs return an exit code of 0 when they are
  14573.                            successful and a number between 1 and 255 to
  14574.                            indicate an error.  The condition can be any of
  14575.  
  14576.  
  14577.           ___________________________________________________________________
  14578.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  248
  14579.  
  14580.                                    CHAPTER 8 / COMMAND REFERENCE GUIDE  /  IF
  14581.           ___________________________________________________________________
  14582.  
  14583.  
  14584.                            the numeric operators listed above (EQ, !=, GT,
  14585.                            etc.).  If no relational operator is specified,
  14586.                            the default is GE.  The comparison between the
  14587.                            exit code and n is done numerically.
  14588.  
  14589.                            Not all programs return an explicit exit code.
  14590.                            For programs which do not, the behavior of
  14591.                            ERRORLEVEL is undefined and may be erratic.
  14592.  
  14593.                         EXIST filename
  14594.  
  14595.                            If the file exists, the condition is true.  You
  14596.                            can use wildcards in the filename, in which case
  14597.                            the condition is true if any file matching the
  14598.                            wildcards exists.
  14599.  
  14600.                         ISALIAS aliasname
  14601.  
  14602.                            If the specified name is an alias, the condition
  14603.                            is true.
  14604.  
  14605.                         [ISDIR | DIREXIST] path
  14606.  
  14607.                            If the subdirectory exists, the condition is
  14608.                            true.  For compatibility with DR-DOS, DIREXIST
  14609.                            may be used as a synonym for ISDIR.
  14610.  
  14611.                         ISINTERNAL command
  14612.  
  14613.                            If the specified command is an active, internal
  14614.                            4DOS command, the condition is true.  Commands
  14615.                            can be activated and deactivated with the SETDOS
  14616.                            /I command.
  14617.  
  14618.                         The first batch file fragment below tests for the
  14619.                         existence of A:\JAN.DOC before copying it to drive
  14620.                         C.
  14621.  
  14622.                                 if exist a:\jan.doc copy a:\jan.doc c:\
  14623.  
  14624.                         This example tests the exit code of the previous
  14625.                         program and stops batch file processing if an error
  14626.                         occurred:
  14627.  
  14628.                                 if errorlevel==0 goto success
  14629.                                 echo "External Error -- Batch File Ends!"
  14630.                                 cancel
  14631.  
  14632.  
  14633.  
  14634.           ___________________________________________________________________
  14635.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  249
  14636.  
  14637.                                    CHAPTER 8 / COMMAND REFERENCE GUIDE  /  IF
  14638.           ___________________________________________________________________
  14639.  
  14640.  
  14641.                       Combining Tests:
  14642.  
  14643.                         You can negate the result of any test with NOT, and
  14644.                         combine tests of any sort with .AND., .OR., and
  14645.                         .XOR.  Test conditions are always scanned from left
  14646.                         to right -- there is no implied order of precedence,
  14647.                         as there is in some programming languages.
  14648.  
  14649.                         When two tests are combined with .AND., the result
  14650.                         is true if both of the individual tests are true.
  14651.                         When two tests are combined with .OR., the result is
  14652.                         true if either (or both) of the individual tests are
  14653.                         true.  When two tests are combined with .XOR., the
  14654.                         result is true only if one of the tests is true and
  14655.                         the other is false.
  14656.  
  14657.                         This example runs a program called HIGHRES if either
  14658.                         an EGA or VGA video adapter is in use:
  14659.  
  14660.                               if "%_video"=="EGA" .or. "%_video"==vga highres
  14661.  
  14662.  
  14663.  
  14664.  
  14665.  
  14666.  
  14667.  
  14668.  
  14669.  
  14670.  
  14671.  
  14672.  
  14673.  
  14674.  
  14675.  
  14676.  
  14677.  
  14678.  
  14679.  
  14680.  
  14681.  
  14682.  
  14683.  
  14684.  
  14685.  
  14686.  
  14687.  
  14688.  
  14689.  
  14690.  
  14691.           ___________________________________________________________________
  14692.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  250
  14693.  
  14694.                                   CHAPTER 8 / COMMAND REFERENCE GUIDE  /  IFF
  14695.           ___________________________________________________________________
  14696.  
  14697.  
  14698.           IFF                                                           (New)
  14699.  
  14700.           Purpose:    Allow IF / THEN / ELSE conditional execution of
  14701.                       commands.
  14702.  
  14703.           Format:     IFF [NOT] condition [.AND. | .OR. | .XOR. [NOT]
  14704.                          condition ...] THEN ^ commands
  14705.                       [ELSEIFF condition  THEN ^ commands ] ...
  14706.                       [ELSE ^ commands ]
  14707.                       ^ ENDIFF
  14708.  
  14709.                       condition:  A test to determine if the command(s)
  14710.                       should be executed.
  14711.                       commands:  One or more commands to execute if the
  14712.                       condition(s) is true.  If you use multiple commands,
  14713.                       they must be separated by carets or be placed on
  14714.                       separate lines of a batch file.
  14715.  
  14716.                       See also: IF
  14717.  
  14718.           Usage:      IFF is similar to the IF command, except that it can
  14719.                       perform one set of commands when a condition or set of
  14720.                       conditions is true and different commands when the
  14721.                       conditions are false.
  14722.  
  14723.                       IFF can execute multiple commands when the conditions
  14724.                       are true or false; IF normally executes only one
  14725.                       command.  IFF imposes no limit on the number of
  14726.                       commands and is generally a "cleaner" and more
  14727.                       structured command than IF.
  14728.  
  14729.                       IFF is always followed by one or more conditions, which
  14730.                       4DOS evaluates.  If they are true, 4DOS executes the
  14731.                       commands that follow the word THEN.  Additional
  14732.                       conditions can be tested with ELSEIFF.  If none of
  14733.                       these conditions are true, 4DOS executes the commands
  14734.                       that follow the word ELSE.  In both cases, after the
  14735.                       selected commands are executed, processing continues
  14736.                       after the word ENDIFF.
  14737.  
  14738.                       If you add a NOT before the condition, the THEN
  14739.                       commands are executed only when the condition is false
  14740.                       and the ELSE commands are executed only when the
  14741.                       condition is true.
  14742.  
  14743.                       You can link conditions with .AND., .OR., or .XOR., and
  14744.                       you can nest IFF statements up to 15 deep.  The
  14745.                       conditions can test strings or numbers, the existence
  14746.  
  14747.  
  14748.           ___________________________________________________________________
  14749.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  251
  14750.  
  14751.                                   CHAPTER 8 / COMMAND REFERENCE GUIDE  /  IFF
  14752.           ___________________________________________________________________
  14753.  
  14754.  
  14755.                       of a file or subdirectory, the errorlevel returned from
  14756.                       the preceding external command, and the existence of
  14757.                       alias names and internal commands.
  14758.  
  14759.                       See the IF command for a list of the possible
  14760.                       conditions.
  14761.  
  14762.                       The commands can include any 4DOS internal command or
  14763.                       alias, external command, or batch file.
  14764.  
  14765.                       The following batch file fragment tests the monitor
  14766.                       type (monochrome or color), and sets the appropriate
  14767.                       colors and prompt (enter the "prompt" lines on one line
  14768.                       of the batch file):
  14769.  
  14770.                            iff "%_monitor" == "color" then
  14771.                              color bright white on blue ^ cls
  14772.                              prompt=$e[s$e[1;1f$e[41;1;37m$e[K  Path:
  14773.                                 $p$e[u$e[44;37m$n$g
  14774.                            else
  14775.                              prompt=$e[s$e[1;1f$e[0;7m$e[K  Path:
  14776.                                 $p$e[u$e[0m$n$g
  14777.                            endiff
  14778.  
  14779.                       The alias in this second example checks to see if the
  14780.                       argument is a subdirectory.  If so, the alias deletes
  14781.                       the subdirectory's files and removes it (enter this on
  14782.                       one line):
  14783.  
  14784.                            c:\> alias prune `iff isdir %1 then ^
  14785.                                 del /sxz %1 ^ rd %1 ^ else ^
  14786.                                 echo Not a directory!^endiff`
  14787.  
  14788.                   ##  If you do a GOTO inside an IFF, 4DOS normally assumes
  14789.                       you are jumping outside of all active IFF statements.
  14790.                       If you attempt to GOTO another part of the same IFF,
  14791.                       the middle of another IFF, or a different IFF nesting
  14792.                       level, you will eventually receive an "unknown command"
  14793.                       error on a subsequent ELSE, ELSEIFF, or ENDIFF
  14794.                       statement.  You can override this restriction with GOTO
  14795.                       /I, but do so only if you are absolutely certain that
  14796.                       your GOTO command is branching entirely within the
  14797.                       current active IFF statement.  Using /I under any other
  14798.                       conditions will cause an error later in your batch
  14799.                       file.
  14800.  
  14801.  
  14802.  
  14803.  
  14804.  
  14805.           ___________________________________________________________________
  14806.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  252
  14807.  
  14808.                                 CHAPTER 8 / COMMAND REFERENCE GUIDE  /  INKEY
  14809.           ___________________________________________________________________
  14810.  
  14811.  
  14812.           INKEY                                                         (New)
  14813.  
  14814.           Purpose:    Get a single keystroke from the user and store it in an
  14815.                       environment variable.
  14816.  
  14817.           Format:     INKEY [/K"keys" /Wn] [prompt] %%varname
  14818.  
  14819.                       prompt:  Optional text that is displayed as a prompt.
  14820.                       varname:  The variable that will hold the user's
  14821.                       keystroke.
  14822.  
  14823.                       /K (valid keystrokes)       /W(ait)
  14824.  
  14825.                       See also: INPUT and KEYSTACK.
  14826.  
  14827.           Usage:      INKEY optionally displays a prompt for user input.
  14828.                       Then it waits for a specified time or indefinitely for
  14829.                       a keystroke, and places the keystroke into an
  14830.                       environment variable.  It is normally used in batch
  14831.                       files and aliases to get a menu choice or other single-
  14832.                       key input from the user.  Along with the INPUT command,
  14833.                       INKEY allows great flexibility in reading user input
  14834.                       from within a batch file or alias.
  14835.  
  14836.                       If prompt text is included in an INKEY command, it is
  14837.                       displayed while INKEY waits for input.
  14838.  
  14839.                       The following batch file fragment prompts for a
  14840.                       character and stores it in the variable NUM:
  14841.  
  14842.                            inkey Enter a number from 1 to 9:  %%num
  14843.  
  14844.                       INKEY reads standard input for the keystroke, so it
  14845.                       will accept keystrokes from a redirected file or from
  14846.                       the KEYSTACK.  You can supply a list of valid
  14847.                       keystrokes with the /K option.
  14848.  
  14849.                       Standard keystrokes with ASCII values between 1 and 255
  14850.                       are stored directly in the environment variable.
  14851.                       Extended keystrokes (for example, function keys and
  14852.                       cursor keys) are stored as a string in decimal format,
  14853.                       with a leading @ (for example, the F1 key is @59).  The
  14854.                       Enter key is stored as an extended keystroke, with the
  14855.                       code @28.  See Appendix B (page 338) for a list of the
  14856.                       ASCII and extended key codes.
  14857.  
  14858.                       If you press Ctrl-C or Ctrl-BREAK while INKEY is
  14859.                       waiting for a key, execution of an alias will be
  14860.  
  14861.  
  14862.           ___________________________________________________________________
  14863.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  253
  14864.  
  14865.                                 CHAPTER 8 / COMMAND REFERENCE GUIDE  /  INKEY
  14866.           ___________________________________________________________________
  14867.  
  14868.  
  14869.                       terminated, and execution of a batch file will be
  14870.                       suspended while you are asked whether to cancel the
  14871.                       batch job.
  14872.  
  14873.           Options:    /K:  Specify the permissible keystrokes.  The list of
  14874.                       valid keystrokes should be enclosed in double quotes
  14875.                       ["keys"].  For alphabetic keys the validity test is not
  14876.                       case-sensitive.  You can specify extended keys by
  14877.                       enclosing their names in square brackets (within the
  14878.                       quotes), for example:
  14879.  
  14880.                            inkey /k"ab[Alt-F10]" Enter A, B, or Alt-F10
  14881.                            %%var
  14882.  
  14883.                       If an invalid keystroke is entered 4DOS will echo the
  14884.                       keystroke if possible, beep, move the cursor back one
  14885.                       character, and wait for another keystroke.
  14886.  
  14887.                       Key names within square brackets are entered in the
  14888.                       form:
  14889.  
  14890.                            Prefix-Keyname
  14891.  
  14892.                       The key prefix is optional, and can be any one of the
  14893.                       following:
  14894.  
  14895.                         Alt        followed by A - Z, 0 - 9, F1 - F12, or
  14896.                                    Bksp
  14897.                         Ctrl       followed by A - Z, F1 - F12, Bksp, Enter,
  14898.                                    Left, Right, Home, End, PgUp, PgDn, Ins,
  14899.                                    or Del
  14900.                         Shift      followed by F1 - F12 or Tab.
  14901.  
  14902.                       The possible key names are:
  14903.  
  14904.                         A - Z         Enter         PgDn
  14905.                         0 - 9         Up            Home
  14906.                         F1 - F12      Down          End
  14907.                         Esc           Left          Ins
  14908.                         Bksp          Right         Del
  14909.                         Tab           PgUp
  14910.  
  14911.                       All key names must be spelled as shown, and can be
  14912.                       abbreviated as long as the abbreviation is unique and
  14913.                       unambiguous.  The prefix must be separated from the key
  14914.                       name with a dash.
  14915.  
  14916.  
  14917.  
  14918.  
  14919.           ___________________________________________________________________
  14920.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  254
  14921.  
  14922.                                 CHAPTER 8 / COMMAND REFERENCE GUIDE  /  INKEY
  14923.           ___________________________________________________________________
  14924.  
  14925.  
  14926.                       /W(ait):  Timeout period,  in seconds, to wait for a
  14927.                       response.  If no keystroke is entered by the end of the
  14928.                       timeout period, INKEY returns with the variable
  14929.                       unchanged.  You can specify /W0 to return immediately
  14930.                       if there are no keys waiting in the keyboard buffer.
  14931.  
  14932.                       For example, the following batch file fragment waits up
  14933.                       to 10 seconds for a character, then tests to see if a
  14934.                       "Y" was entered:
  14935.  
  14936.                            set net=N
  14937.                            inkey /K"YN" /w10 Load the network (Y/N)?  %%net
  14938.                            iff "%net" == "Y" then
  14939.                              rem Commands to load the network go here
  14940.                            endiff
  14941.  
  14942.  
  14943.  
  14944.  
  14945.  
  14946.  
  14947.  
  14948.  
  14949.  
  14950.  
  14951.  
  14952.  
  14953.  
  14954.  
  14955.  
  14956.  
  14957.  
  14958.  
  14959.  
  14960.  
  14961.  
  14962.  
  14963.  
  14964.  
  14965.  
  14966.  
  14967.  
  14968.  
  14969.  
  14970.  
  14971.  
  14972.  
  14973.  
  14974.  
  14975.  
  14976.           ___________________________________________________________________
  14977.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  255
  14978.  
  14979.                                 CHAPTER 8 / COMMAND REFERENCE GUIDE  /  INPUT
  14980.           ___________________________________________________________________
  14981.  
  14982.  
  14983.           INPUT                                                         (New)
  14984.  
  14985.           Purpose:    Get a string from the keyboard and save it in an
  14986.                       environment variable.
  14987.  
  14988.           Format:     INPUT [/Wn] [prompt] %%varname
  14989.  
  14990.                       prompt:  Optional text that is displayed as a prompt.
  14991.                       varname:  The variable that will hold the user's input.
  14992.  
  14993.                       /W(ait)
  14994.  
  14995.                       See also: INKEY and KEYSTACK.
  14996.  
  14997.           Usage:      INPUT optionally displays a prompt for user input.
  14998.                       Then it waits for a specified time or indefinitely for
  14999.                       the user's entry.  It places any characters typed by
  15000.                       the user into an environment variable.  INPUT is
  15001.                       normally used in batch files and aliases to get multi-
  15002.                       key input from the user.  Along with the INKEY command,
  15003.                       INPUT allows great flexibility in reading user input
  15004.                       from within a batch file or alias.
  15005.  
  15006.                       If prompt text is included in an INPUT command, it is
  15007.                       displayed while INPUT waits for input.  Standard 4DOS
  15008.                       command line editing keys may be used to edit the input
  15009.                       string as it is entered.
  15010.  
  15011.                       All characters entered up to, but not including, the
  15012.                       carriage return are stored in the variable.
  15013.  
  15014.                       The following batch file fragment prompts for a string
  15015.                       and stores it in the variable FNAME:
  15016.  
  15017.                            input Enter the file name:  %%fname
  15018.  
  15019.                       INPUT reads standard input, so it will accept text from
  15020.                       a re-directed file or from the KEYSTACK.
  15021.  
  15022.           Option:     /W(ait):  Timeout period,  in seconds, to wait for a
  15023.                       response.  If no keystroke is entered by the end of the
  15024.                       timeout period, INPUT returns with the variable
  15025.                       unchanged.  If you enter a key before the timeout
  15026.                       period, INPUT will wait indefinitely for the remainder
  15027.                       of the line.  You can specify /W0 to return immediately
  15028.                       if there are no keys waiting in the keyboard buffer.
  15029.  
  15030.  
  15031.  
  15032.  
  15033.           ___________________________________________________________________
  15034.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  256
  15035.  
  15036.                              CHAPTER 8 / COMMAND REFERENCE GUIDE  /  KEYSTACK
  15037.           ___________________________________________________________________
  15038.  
  15039.  
  15040.           KEYSTACK                                                      (New)
  15041.  
  15042.           Purpose:    Feed keystrokes to a program or command automatically.
  15043.  
  15044.           Format:     KEYSTACK [/Wn] ["abc"] [keyname] [!] ...
  15045.  
  15046.                       "abc":  Literal characters to be placed in the
  15047.                       Keystack.
  15048.                       keyname:  Name or code for a key to be placed in the
  15049.                       Keystack.
  15050.                       !:  Signal to clear the Keystack and the keyboard
  15051.                       buffer.
  15052.  
  15053.                       /W(ait)
  15054.  
  15055.           Usage:      KEYSTACK takes a series of keystrokes and feeds them to
  15056.                       a program or command as if they were typed at the
  15057.                       keyboard.  When the program has used all of the
  15058.                       keystrokes in the keystack buffer, it will begin to
  15059.                       read the keyboard for input, as it normally would.
  15060.  
  15061.                       KEYSTACK will only work if the memory-resident program
  15062.                       KSTACK.COM has been loaded.  KSTACK is usually loaded
  15063.                       from the AUTOEXEC.BAT file (see page 115).  It can also
  15064.                       be loaded with an INSTALL= directive in CONFIG.SYS if
  15065.                       you wish and your version of DOS supports INSTALL= (see
  15066.                       your DOS manual for details).  If KSTACK is not loaded
  15067.                       the KEYSTACK command will display an error message.  If
  15068.                       you are using a multitasking system such as DESQview or
  15069.                       Windows, see page 155 for information on loading KSTACK
  15070.                       within a window.
  15071.  
  15072.                       Characters entered within double quotes ("abc") will be
  15073.                       stored "as is" in the keyboard buffer.  The only items
  15074.                       allowed outside double quotes are key names, key codes,
  15075.                       and the /W option.
  15076.  
  15077.                       Key names are entered in the form:
  15078.  
  15079.                            [Prefix-]Keyname
  15080.  
  15081.                       The key prefix can be left out, in which case any of
  15082.                       the key names can be used except A - Z or 0 - 9.  If
  15083.                       the key prefix is used it can be any one of the
  15084.                       following:
  15085.  
  15086.                         Alt        followed by A - Z, 0 - 9, F1 - F12, or
  15087.                                    Bksp
  15088.  
  15089.  
  15090.           ___________________________________________________________________
  15091.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  257
  15092.  
  15093.                              CHAPTER 8 / COMMAND REFERENCE GUIDE  /  KEYSTACK
  15094.           ___________________________________________________________________
  15095.  
  15096.  
  15097.                         Ctrl       followed by A - Z, F1 - F12, Bksp, Enter,
  15098.                                    Left, Right, Home, End, PgUp, PgDn, Ins,
  15099.                                    or Del
  15100.                         Shift      followed by F1 - F12 or Tab.
  15101.  
  15102.                       The possible key names are:
  15103.  
  15104.                         A - Z         Enter         PgDn
  15105.                         0 - 9         Up            Home
  15106.                         F1 - F12      Down          End
  15107.                         Esc           Left          Ins
  15108.                         Bksp          Right         Del
  15109.                         Tab           PgUp
  15110.  
  15111.                       All key names must be spelled as shown, and can be
  15112.                       abbreviated as long as the abbreviation is unique and
  15113.                       unambiguous.
  15114.  
  15115.                       The prefix and key name must be separated by a dash.
  15116.                       For example,
  15117.  
  15118.                            Alt-F10        This is okay
  15119.                            Alt F10        The space will cause an error
  15120.  
  15121.                       If you prefer, you can use a numeric value instead of a
  15122.                       key name.  Use the ASCII code for an ASCII, extended
  15123.                       ASCII, or control character.  Use the scan code
  15124.                       preceded by an at-sign [@] for extended key codes like
  15125.                       F1 or the cursor keys.  In general, you will find it
  15126.                       easier to use the names described above rather than key
  15127.                       numbers.  See Appendix B (page 338) for an explanation
  15128.                       and list of keyboard codes.
  15129.  
  15130.                       An exclamation mark [!] will clear all pending
  15131.                       keystrokes, both in the KEYSTACK buffer and in the
  15132.                       keyboard buffer.
  15133.  
  15134.                       For example, to start ProComm Plus and skip the opening
  15135.                       screen you could use the command:
  15136.  
  15137.                            c:\comm> keystack 32 ^ pcplus
  15138.  
  15139.                       This places a space (ASCII code 32) in the buffer, then
  15140.                       runs ProComm Plus.  When ProComm looks for a keystroke
  15141.                       to end the display of the opening screen the keystroke
  15142.                       is already in the buffer, so the opening screen is
  15143.                       removed immediately.
  15144.  
  15145.  
  15146.  
  15147.           ___________________________________________________________________
  15148.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  258
  15149.  
  15150.                              CHAPTER 8 / COMMAND REFERENCE GUIDE  /  KEYSTACK
  15151.           ___________________________________________________________________
  15152.  
  15153.  
  15154.                       The KEYSTACK command must be executed before running
  15155.                       the program which is going to receive the stacked
  15156.                       keystrokes.  This places the keystrokes into the buffer
  15157.                       first, so the program can find them when it runs.
  15158.  
  15159.                       You can store a maximum of 255 characters in the
  15160.                       KEYSTACK buffer.  Each time the KEYSTACK command is
  15161.                       executed, it will clear any remaining keystrokes stored
  15162.                       by a previous KEYSTACK command.
  15163.  
  15164.                       You may need to experiment with your programs and
  15165.                       insert delays (see the /W option) to find a keystroke
  15166.                       sequence that works for any particular program.
  15167.  
  15168.                       Programs that bypass DOS and the BIOS for keyboard
  15169.                       input cannot read keystrokes entered with KEYSTACK.  If
  15170.                       you use KEYSTACK then run such a program, the
  15171.                       keystrokes will not appear in the program, but may
  15172.                       appear at the prompt when you exit the program and
  15173.                       return to 4DOS.
  15174.  
  15175.                   ##  KEYSTACK treats the number 0 as a special case; it is
  15176.                       used with programs that flush the keyboard buffer.
  15177.                       When KEYSTACK processes a key value of 0, it tells the
  15178.                       program the buffer is clear, so subsequent keystrokes
  15179.                       will be accepted normally.  Some programs will require
  15180.                       several "0"s before they will accept input; you may
  15181.                       need to experiment to determine the correct number.
  15182.  
  15183.                       For example, the following batch file starts Lotus 1-2-
  15184.                       3 and loads the file specified on the command line when
  15185.                       the batch file is invoked (the KEYSTACK command should
  15186.                       be entered on one line):
  15187.  
  15188.                            pushd c:\123
  15189.                            keystack 0 Enter 0 Enter 0 Enter 0 Enter 0 Enter
  15190.                              "/FR" 0 "%1" Enter
  15191.                            123
  15192.                            popd
  15193.  
  15194.                       The sequence of "0 Enter" pairs tells 1-2-3 that the
  15195.                       keyboard buffer is empty, then passes 1-2-3 a carriage
  15196.                       return, repeating this sequence five times.  This gets
  15197.                       1-2-3 to a point where an empty spreadsheet is
  15198.                       displayed.  The rest of the KEYSTACK line issues a File
  15199.                       Retrieve command (/FR), simulates an empty keyboard
  15200.                       buffer once more, enters the file name passed on the
  15201.  
  15202.  
  15203.  
  15204.           ___________________________________________________________________
  15205.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  259
  15206.  
  15207.                              CHAPTER 8 / COMMAND REFERENCE GUIDE  /  KEYSTACK
  15208.           ___________________________________________________________________
  15209.  
  15210.  
  15211.                       batch command line (%1), and finally enters a carriage
  15212.                       return to end the file name.
  15213.  
  15214.                   ##  Here's the same command defined as an alias (enter this
  15215.                       on one line):
  15216.  
  15217.                            alias 321 `pushd c:\123 ^ keystack 0 Enter 0
  15218.                            Enter 0 Enter 0 Enter 0 Enter "/FR" 0 "%1" 13 ^
  15219.                            123 ^ popd`
  15220.  
  15221.                   ##  Some programs require both the keyboard "scan code" and
  15222.                       the ASCII value to be stacked.  To stack both codes,
  15223.                       calculate the value ((256 * scan code) + ASCII code)
  15224.                       and enter that numeric value as an argument for
  15225.                       KEYSTACK.  For example, for the Enter key, the scan
  15226.                       code is 28 and the ASCII code is 13, so to stack both
  15227.                       values use ((256 * 28) + 13) or KEYSTACK 7181.  Try
  15228.                       this approach if a "normal" KEYSTACK command does not
  15229.                       work (for example, if you use KEYSTACK 13 for the Enter
  15230.                       key and the program doesn't see the correct character).
  15231.                       To stack combined key codes you must use the numeric
  15232.                       value, not the key name (see Appendix B on page 338 for
  15233.                       keyboard codes).
  15234.  
  15235.           Options:##  /W(ait):  Delay the next keystroke in the KEYSTACK
  15236.                       buffer by a specified number of clock "ticks".  A clock
  15237.                       tick is approximately 1/18 second.  The number of clock
  15238.                       ticks to delay should be placed immediately after the
  15239.                       W, and must be between 1 and 65535 (65535 ticks is
  15240.                       about 1 hour).  You can use the /W option as many times
  15241.                       as desired and at any point in the string of keystrokes
  15242.                       except within double quotes.  Some programs may need
  15243.                       the delays provided by /W in order to receive
  15244.                       keystrokes properly from KEYSTACK.  The only way to
  15245.                       determine what delay is needed is to experiment.
  15246.                       Sometimes a combination of a delay and an "empty
  15247.                       buffer" signal (a 0) are required.  For example, to
  15248.                       start the program CADX and send it an F7, a delay of
  15249.                       one second, an indication that the keyboard buffer is
  15250.                       empty, and a carriage return:
  15251.  
  15252.                            c:\> keystack F7 /W18 0 Enter ^ cadx
  15253.  
  15254.  
  15255.  
  15256.  
  15257.  
  15258.  
  15259.  
  15260.  
  15261.           ___________________________________________________________________
  15262.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  260
  15263.  
  15264.                         CHAPTER 8 / COMMAND REFERENCE GUIDE  /  LH / LOADHIGH
  15265.           ___________________________________________________________________
  15266.  
  15267.  
  15268.           LH / LOADHIGH                                          (Compatible)
  15269.  
  15270.           Purpose:    Load a memory resident program into an Upper Memory
  15271.                       Block (UMB).
  15272.  
  15273.           Format:     LH [/L:r1,n1;r2,n2;... /S] filename
  15274.                            or
  15275.                       LOADHIGH [/L:r1,n1;r2,n2;... /S] filename
  15276.  
  15277.                       /L(oad to specific regions) /S(hrink)
  15278.  
  15279.                       filename:  The name of the program to load into high
  15280.                       memory.
  15281.  
  15282.           Usage:      LH and LOADHIGH are synonyms.  You can use either one.
  15283.  
  15284.                       LOADHIGH requires MS-DOS 5.0 or above, DR-DOS 6.0 or
  15285.                       above, or OS/2 2.0 or above.  Under DR-DOS, LOADHIGH is
  15286.                       equivalent to the DR-DOS HILOAD command.
  15287.  
  15288.                       If you load memory-resident programs into UMBs, you
  15289.                       will have more room in base memory for application
  15290.                       programs.  If your system has no UMBs, or if the
  15291.                       program is larger than the largest UMB, then LOADHIGH
  15292.                       will load the program into conventional base memory.
  15293.  
  15294.                       For example, to load the program C:\UTIL\CACHE.EXE into
  15295.                       high memory:
  15296.  
  15297.                            c:\> loadhigh c:\util\cache.exe
  15298.  
  15299.                       Under MS-DOS 5.0 or above, LOADHIGH requires the
  15300.                       DOS=UMB command in your CONFIG.SYS file.  Under OS/2
  15301.                       2.x, LOADHIGH requires DOS=UMB in CONFIG.SYS, or
  15302.                       DOS_UMB set ON in the settings for your DOS session.
  15303.  
  15304.                       If you use a memory manager like 386MAX or QEMM to
  15305.                       manage your UMBs, and do not enable DOS UMB management
  15306.                       as described above, then LOADHIGH will not work, and
  15307.                       you sjould use the equivalent command supplied with
  15308.                       your memory manager to load programs high.
  15309.  
  15310.                   ##  Upper memory is divided into one or more contiguous
  15311.                       "regions".  The LH options allow you to load a memory-
  15312.                       resident program into a specific region.  To use these
  15313.                       options you must be running MS-DOS 5.0 or above, or a
  15314.                       DOS session under OS/2 2.0 or above.  In addition, you
  15315.                       must have one of the following memory management
  15316.  
  15317.  
  15318.           ___________________________________________________________________
  15319.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  261
  15320.  
  15321.                         CHAPTER 8 / COMMAND REFERENCE GUIDE  /  LH / LOADHIGH
  15322.           ___________________________________________________________________
  15323.  
  15324.  
  15325.                       packages running:  EMM386 and HIMEM.SYS from MS-DOS /
  15326.                       PC-DOS 5.0 or above; 386MAX from Qualitas; QEMM from
  15327.                       Quarterdeck; or DOS session support under OS/2 2.x.
  15328.  
  15329.           Options:##  /L:r1,n1;r2,n2;...:  Give the program access to upper
  15330.                       memory region r1 if that region has at least n1 bytes
  15331.                       available, to region r2 if it has at least n2 bytes
  15332.                       available, and so on.
  15333.  
  15334.                       If /L is not used, the program is given access to all
  15335.                       upper memory regions.  If /L is used, any regions not
  15336.                       listed will be locked out and unavailable to the
  15337.                       program.  In addition, if the free space in any region
  15338.                       is less than the space required for that region, then
  15339.                       the region will be locked out and unavailable to the
  15340.                       program.  If a region is listed but the required space
  15341.                       value is not, then the program is given access to the
  15342.                       region regardless of the amount of free space
  15343.                       available.
  15344.  
  15345.                       Regions are numbered beginning with 1.  If you specify
  15346.                       region 0 the program and its environment will be loaded
  15347.                       into low memory, and any other region(s) specified will
  15348.                       be available for allocation of program data.  Any
  15349.                       minimum size for region 0 will be ignored.  Region
  15350.                       numbers beyond those that exist on your system will be
  15351.                       ignored, with a warning.  The figures for space
  15352.                       required in each region (n1, n2, etc.) are rounded up
  15353.                       to the nearest 16 bytes.
  15354.  
  15355.                       For example, to load a program into region 2 only,
  15356.                       regardless of the space available in that region:
  15357.  
  15358.                            c:\> lh /l:2 progname ...
  15359.  
  15360.                       To load the program into region 2 if it has at least
  15361.                       10,000 bytes free, and make region 3 available as well
  15362.                       if it has at least 15,000 bytes free:
  15363.  
  15364.                            lh /l:2,10000;3,15000 ...
  15365.  
  15366.                       /S:  Shrink each specified region to the minimum
  15367.                       available size before loading the program.  If /S is
  15368.                       not used all space in the specified region(s) is made
  15369.                       available to the program.  You can use /S to prevent a
  15370.                       program from taking more than the minimum specified
  15371.                       space in a particular region (e.g. to limit memory used
  15372.                       by a cache that takes whatever memory it can get).
  15373.  
  15374.  
  15375.           ___________________________________________________________________
  15376.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  262
  15377.  
  15378.                         CHAPTER 8 / COMMAND REFERENCE GUIDE  /  LH / LOADHIGH
  15379.           ___________________________________________________________________
  15380.  
  15381.  
  15382.                       For example, to load a cache program into low memory,
  15383.                       give the program access to region 2 for data as long as
  15384.                       there is at least 16K free in region 2, and also limit
  15385.                       the program to using no more than that 16K:
  15386.  
  15387.                            lh /l:0;2,16384 /s mycache ...
  15388.  
  15389.                       The /S switch is intended for use by MS-DOS 6.0's
  15390.                       MEMMAKER utility.  It will not be especially useful for
  15391.                       other purposes unless you are involved in complex
  15392.                       manual adjustments to upper memory allocations, and
  15393.                       have a thorough understanding of the memory allocation
  15394.                       strategies used by the programs involved.
  15395.  
  15396.  
  15397.  
  15398.  
  15399.  
  15400.  
  15401.  
  15402.  
  15403.  
  15404.  
  15405.  
  15406.  
  15407.  
  15408.  
  15409.  
  15410.  
  15411.  
  15412.  
  15413.  
  15414.  
  15415.  
  15416.  
  15417.  
  15418.  
  15419.  
  15420.  
  15421.  
  15422.  
  15423.  
  15424.  
  15425.  
  15426.  
  15427.  
  15428.  
  15429.  
  15430.  
  15431.  
  15432.           ___________________________________________________________________
  15433.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  263
  15434.  
  15435.                                  CHAPTER 8 / COMMAND REFERENCE GUIDE  /  LIST
  15436.           ___________________________________________________________________
  15437.  
  15438.  
  15439.           LIST                                                          (New)
  15440.  
  15441.           Purpose:    Display a file, with forward and backward paging and
  15442.                       scrolling.
  15443.  
  15444.           Format:     LIST [/H /S /W] file...
  15445.  
  15446.                       file:  A file or list of files to display.
  15447.  
  15448.                       /H(igh bit off)             /W(rap)
  15449.                       /S(tandard input)
  15450.  
  15451.                       See also: TYPE.
  15452.  
  15453.           Usage:      LIST provides a much faster and more flexible way to
  15454.                       view a file than TYPE, without the overhead of loading
  15455.                       and using a text editor.
  15456.  
  15457.                       LIST is normally used for displaying ASCII text files.
  15458.                       Most other files contain non-alphabetic characters and
  15459.                       may be unreadable.
  15460.  
  15461.                       For example, to display a file called MEMO.DOC:
  15462.  
  15463.                            c:\> list memo.doc
  15464.  
  15465.                       LIST uses the cursor pad to scroll through the file.
  15466.                       The following keys have special meanings:
  15467.  
  15468.                            Home              Display the first page of the
  15469.                                              file.
  15470.                            End               Display the last page of the
  15471.                                              file.
  15472.                            Esc               Exit the current file.
  15473.                            Ctrl-C            Quit LIST.
  15474.                            Up Arrow          Scroll up one line.
  15475.                            Down Arrow        Scroll down one line.
  15476.                            Left Arrow        Scroll left 8 columns.
  15477.                            Right Arrow       Scroll right 8 columns.
  15478.                            Ctrl- Left Arrow  Scroll left 40 columns.
  15479.                            Ctrl-Right Arrow  Scroll right 40 columns.
  15480.                            F1                Call the 4DOS online help
  15481.                            F                 Prompt and search for a string
  15482.                                              (case is ignored).
  15483.                            H                 Toggle the "strip high bit" (/H)
  15484.                                              option.
  15485.                            N                 Find next matching string (case
  15486.                                              is ignored).
  15487.  
  15488.  
  15489.           ___________________________________________________________________
  15490.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  264
  15491.  
  15492.                                  CHAPTER 8 / COMMAND REFERENCE GUIDE  /  LIST
  15493.           ___________________________________________________________________
  15494.  
  15495.  
  15496.                            P                 Print the entire file on LPT1.
  15497.                            W                 Toggle the "line wrap" (/W)
  15498.                                              option.
  15499.  
  15500.                       LIST saves the search string used by F and N, so you
  15501.                       can LIST multiple files and search for the same string
  15502.                       simply by pressing N in each file, or repeat your
  15503.                       search the next time you use LIST.
  15504.  
  15505.                   ##  Most of the LIST keystrokes can be reassigned with
  15506.                       4DOS.INI file directives (see pages 133 and 137).
  15507.  
  15508.                   ##  You can set the default colors used by LIST (and
  15509.                       SELECT) using the ListColors directive in 4DOS.INI.  If
  15510.                       ListColors is not used the LIST display will use the
  15511.                       current screen colors.
  15512.  
  15513.           Options:##  /H(igh bit off):  Strip the high bit from each
  15514.                       character before displaying. This is useful when
  15515.                       displaying files created by some word processors that
  15516.                       turn on the high bit for formatting purposes.  If you
  15517.                       are displaying a word processor text file and see
  15518.                       unusual characters mixed in with the text, try this
  15519.                       option.
  15520.  
  15521.                       /S(tandard input):  Read from the standard input rather
  15522.                       than a file.  This allows you to redirect command
  15523.                       output and view it with LIST.  For example, to use LIST
  15524.                       to display the output of DIR:
  15525.  
  15526.                            c:\> dir | list /s
  15527.  
  15528.                       To redefine the DIR command to always display its
  15529.                       output via LIST, use this alias:
  15530.  
  15531.                            c:\> alias dir `*dir %& | list /s`
  15532.  
  15533.                       /W(rap):  Wrap the text at the right margin.  This
  15534.                       option is useful when displaying files that don't have
  15535.                       a carriage return at the end of each line.  The
  15536.                       horizontal scrolling keys are intended for use when the
  15537.                       display is not wrapped.  If you wrap the display with
  15538.                       /W (or with the W key from within LIST), then use the
  15539.                       scrolling keys, the wrapping will change as each line
  15540.                       is scrolled.  This may produce an unusual display,
  15541.                       depending on the structure of the file you are viewing.
  15542.  
  15543.  
  15544.  
  15545.  
  15546.           ___________________________________________________________________
  15547.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  265
  15548.  
  15549.                               CHAPTER 8 / COMMAND REFERENCE GUIDE  /  LOADBTM
  15550.           ___________________________________________________________________
  15551.  
  15552.  
  15553.           LOADBTM                                                       (New)
  15554.  
  15555.           Purpose:    Switch a batch file to or from BTM mode.
  15556.  
  15557.           Format:     LOADBTM [ON | OFF]
  15558.  
  15559.           Usage:      4DOS recognizes two kinds of batch files: .BAT and
  15560.                       .BTM.  Batch files executing in BTM mode run two to
  15561.                       five times faster than in BAT mode.  However, BTM mode
  15562.                       should not be used to load memory-resident programs,
  15563.                       nor should BTM mode be used for self-modifying batch
  15564.                       files.  Batch files automatically start in the mode
  15565.                       indicated by their file extension, .BAT or .BTM.
  15566.  
  15567.                       The LOADBTM command turns BTM mode on and off.  It can
  15568.                       be used to switch modes in either a .BAT or .BTM file.
  15569.                       It can also be used to display the current batch mode
  15570.                       from inside a batch file when it is used with no
  15571.                       argument.
  15572.  
  15573.                       LOADBTM can only be used within a .BAT or .BTM file.
  15574.                       It is most often used to switch a .BAT file into BTM
  15575.                       mode after memory-resident programs are loaded, to
  15576.                       convert a .BAT file to BTM mode without changing its
  15577.                       extension, or to switch a .BTM file into BAT mode in
  15578.                       order to load memory-resident programs.
  15579.  
  15580.                       Using LOADBTM to repeatedly switch modes within a .BAT
  15581.                       or .BTM file is not efficient.  In most cases, the
  15582.                       speed gained by running some parts of the file in BTM
  15583.                       mode will be more than offset by the speed lost through
  15584.                       repeated loading of the file each time BTM mode is
  15585.                       invoked.
  15586.  
  15587.                       The following .BAT file fragment loads some memory
  15588.                       resident programs (TSRs), and then switches to BTM
  15589.                       mode:
  15590.  
  15591.                            rem   Because this file has a .BAT extension,
  15592.                            rem   the initial default state is LOADBTM OFF
  15593.                            rem   Loading TSRs...
  15594.                            ansi.com
  15595.                            mouse.com
  15596.                            rem   Switch to high-speed (BTM) mode now that
  15597.                            rem   TSRs are loaded
  15598.                            loadbtm on
  15599.                            path c:\;c:\util;c:\dos
  15600.                            alias /r c:\aliases
  15601.  
  15602.  
  15603.           ___________________________________________________________________
  15604.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  266
  15605.  
  15606.                               CHAPTER 8 / COMMAND REFERENCE GUIDE  /  LOADBTM
  15607.           ___________________________________________________________________
  15608.  
  15609.  
  15610.                       For more information on .BTM and .BAT files, see page
  15611.                       99.
  15612.  
  15613.  
  15614.  
  15615.  
  15616.  
  15617.  
  15618.  
  15619.  
  15620.  
  15621.  
  15622.  
  15623.  
  15624.  
  15625.  
  15626.  
  15627.  
  15628.  
  15629.  
  15630.  
  15631.  
  15632.  
  15633.  
  15634.  
  15635.  
  15636.  
  15637.  
  15638.  
  15639.  
  15640.  
  15641.  
  15642.  
  15643.  
  15644.  
  15645.  
  15646.  
  15647.  
  15648.  
  15649.  
  15650.  
  15651.  
  15652.  
  15653.  
  15654.  
  15655.  
  15656.  
  15657.  
  15658.  
  15659.  
  15660.           ___________________________________________________________________
  15661.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  267
  15662.  
  15663.                                   CHAPTER 8 / COMMAND REFERENCE GUIDE  /  LOG
  15664.           ___________________________________________________________________
  15665.  
  15666.  
  15667.           LOG                                                           (New)
  15668.  
  15669.           Purpose:    Save a log of commands to a disk file.
  15670.  
  15671.           Format:     LOG [/W file] [ON | OFF | text]
  15672.  
  15673.                       file:  The name of the file to hold the log.
  15674.                       text:  An optional message that will be added to the
  15675.                       log.
  15676.  
  15677.                       /W(rite to).
  15678.  
  15679.                       See also: HISTORY.
  15680.  
  15681.           Usage:      LOG keeps a record of all internal and external
  15682.                       commands you use.  Each entry includes the current
  15683.                       system date and time, along with the actual command
  15684.                       after any alias or variable expansion.  You can use the
  15685.                       log file as a record of your daily activities.
  15686.  
  15687.                       By default, LOG writes commands to the file 4DOSLOG in
  15688.                       the root directory of the drive specified in your
  15689.                       COMSPEC environment variable (see page 116).
  15690.  
  15691.                       Entering LOG with no parameters displays the log status
  15692.                       (ON or OFF):
  15693.  
  15694.                            c:\> log
  15695.                            LOG is OFF
  15696.  
  15697.                       To enable or disable logging, add the word "ON" or
  15698.                       "OFF" after the LOG command:
  15699.  
  15700.                            c:\> log on
  15701.  
  15702.                       Entering LOG with text writes a message to the log
  15703.                       file, even if LOG is set OFF.  This allows you to enter
  15704.                       headers in the log file:
  15705.  
  15706.                            c:\> log "Started work on the database system"
  15707.  
  15708.                       The LOG file format looks like this:
  15709.  
  15710.                            [mm-dd-yy  hh:mm:ss]  command
  15711.  
  15712.                       The LOG output can be used as the basis for writing
  15713.                       batch files, but you will probably find HISTORY more
  15714.                       effective for this purpose.
  15715.  
  15716.  
  15717.           ___________________________________________________________________
  15718.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  268
  15719.  
  15720.                                   CHAPTER 8 / COMMAND REFERENCE GUIDE  /  LOG
  15721.           ___________________________________________________________________
  15722.  
  15723.  
  15724.           Options:    /W(rite):  This switch specifies a different filename
  15725.                       for the LOG output.  It also automatically performs a
  15726.                       LOG ON command.  For example, to turn logging on and
  15727.                       write the log to C:\LOG\LOGFILE:
  15728.  
  15729.                            c:\> log /w c:\log\logfile
  15730.  
  15731.  
  15732.  
  15733.  
  15734.  
  15735.  
  15736.  
  15737.  
  15738.  
  15739.  
  15740.  
  15741.  
  15742.  
  15743.  
  15744.  
  15745.  
  15746.  
  15747.  
  15748.  
  15749.  
  15750.  
  15751.  
  15752.  
  15753.  
  15754.  
  15755.  
  15756.  
  15757.  
  15758.  
  15759.  
  15760.  
  15761.  
  15762.  
  15763.  
  15764.  
  15765.  
  15766.  
  15767.  
  15768.  
  15769.  
  15770.  
  15771.  
  15772.  
  15773.  
  15774.           ___________________________________________________________________
  15775.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  269
  15776.  
  15777.                            CHAPTER 8 / COMMAND REFERENCE GUIDE  /  MD / MKDIR
  15778.           ___________________________________________________________________
  15779.  
  15780.  
  15781.           MD / MKDIR                                             (Compatible)
  15782.  
  15783.           Purpose:    Create a subdirectory.
  15784.  
  15785.           Format:     MD pathname...
  15786.                            or
  15787.                       MKDIR pathname...
  15788.  
  15789.                       pathname:  The name of one or more directories to
  15790.                       create.
  15791.  
  15792.                       See also: RD.
  15793.  
  15794.           Usage:      MD and MKDIR are synonyms.  You can use either one.
  15795.  
  15796.                       MD creates a subdirectory anywhere in the directory
  15797.                       tree.  To create a subdirectory from the root, start
  15798.                       the pathname with a backslash [\].  For example, this
  15799.                       command creates a subdirectory called MYDIR in the root
  15800.                       directory:
  15801.  
  15802.                            c:\> md \mydir
  15803.  
  15804.                       If no path is given, the new subdirectory is created in
  15805.                       the current directory.  This example creates a
  15806.                       subdirectory called DIRTWO in the current directory:
  15807.  
  15808.                            c:\mydir> md dirtwo
  15809.  
  15810.                       To create a directory from the parent of the current
  15811.                       directory (that is, to create a sibling of the current
  15812.                       directory), start the pathname with two periods and a
  15813.                       backslash [..\].
  15814.  
  15815.                       MD creates one directory at a time.  If you need to
  15816.                       create the directory C:\ONE\TWO\THREE and none of the
  15817.                       named directories exist, you must create each directory
  15818.                       separately.  However, because MD accepts multiple
  15819.                       arguments, you can still create all three directories
  15820.                       in sequence with one command:
  15821.  
  15822.                            c:\> md \one \one\two \one\two\three
  15823.  
  15824.                   ##  DOS will not accept directory names longer than 64
  15825.                       characters.  You must be sure that the complete
  15826.                       directory name from the root to your deepest
  15827.                       subdirectory fits within the 64 character restriction.
  15828.  
  15829.  
  15830.  
  15831.           ___________________________________________________________________
  15832.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  270
  15833.  
  15834.                                CHAPTER 8 / COMMAND REFERENCE GUIDE  /  MEMORY
  15835.           ___________________________________________________________________
  15836.  
  15837.  
  15838.           MEMORY                                                        (New)
  15839.  
  15840.           Purpose:    Display the amount and status of system RAM.
  15841.  
  15842.           Format:     MEMORY
  15843.  
  15844.           Usage:      MEMORY displays information about the RAM in your
  15845.                       system.  It lists the amount of total RAM in your
  15846.                       system and the amount available for applications after
  15847.                       DOS, 4DOS, and memory-resident programs have been
  15848.                       loaded;  the amount of EMS expanded memory, XMS
  15849.                       extended memory, and non-XMS extended memory;  the HMA
  15850.                       status; and the amount of memory 4DOS is using for
  15851.                       environment variable space, alias space, and history
  15852.                       space:
  15853.  
  15854.                            c:\> memory
  15855.                                655,360 bytes total RAM
  15856.                                534,464 bytes free
  15857.  
  15858.                              1,687,552 bytes total EMS memory
  15859.                              1,097,728 bytes free
  15860.  
  15861.                                914,432 bytes total XMS memory (HMA in use)
  15862.  
  15863.                                    512 bytes total environment
  15864.                                    195 bytes free
  15865.  
  15866.                                  1,024 bytes total alias
  15867.                                    452 bytes free
  15868.  
  15869.                                  1,024 bytes total history
  15870.  
  15871.                       You can use the information from the MEMORY display to
  15872.                       fine tune your system, to aid in setting the proper
  15873.                       alias and environment sizes in 4DOS.INI, and to be sure
  15874.                       that you have sufficient memory for your largest
  15875.                       applications.
  15876.  
  15877.                       If you compare the free RAM displayed by MEMORY with
  15878.                       the free RAM displayed by CHKDSK and some memory map
  15879.                       programs, MEMORY will usually show a slightly higher
  15880.                       value.  The difference is the size of the environment
  15881.                       passed to these external programs;  most memory mapping
  15882.                       programs do not count the passed environment as free
  15883.                       space, but MEMORY does.
  15884.  
  15885.  
  15886.  
  15887.  
  15888.           ___________________________________________________________________
  15889.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  271
  15890.  
  15891.                                  CHAPTER 8 / COMMAND REFERENCE GUIDE  /  MOVE
  15892.           ___________________________________________________________________
  15893.  
  15894.  
  15895.           MOVE                                                          (New)
  15896.  
  15897.           Purpose:    Move files to a new directory and drive.
  15898.  
  15899.           Format:     MOVE  [/C /D /H /N /P /Q /R /S /U] source...
  15900.                       destination
  15901.  
  15902.                       source:  A file or list of files to move.
  15903.                       destination:  The new location for the files.
  15904.  
  15905.                       /C(hanged)                  /Q(uiet)
  15906.                       /D(irectory)                /R(eplace)
  15907.                       /H(idden and system)        /S(ubdirectory tree)
  15908.                       /N(othing)                  /U(pdate)
  15909.                       /P(rompt)
  15910.  
  15911.                       See also: COPY and RENAME.
  15912.  
  15913.           Usage:      The MOVE command moves one or more files from one
  15914.                       directory to another, whether the directories are on
  15915.                       the same drive or not.  It has the same effect as
  15916.                       copying the files to a new location and then deleting
  15917.                       the originals.  Like COPY and RENAME, MOVE works with
  15918.                       single files, multiple files, and sets of files
  15919.                       specified with an include list.  Like those commands,
  15920.                       MOVE never changes the attributes of the files that it
  15921.                       operates on.
  15922.  
  15923.                       The simplest MOVE command moves a single source file to
  15924.                       a new location and, optionally, gives it a new name.
  15925.                       These two examples both move one file from drive C: to
  15926.                       the root directory on drive A:
  15927.  
  15928.                            c:\> move myfile.dat a:\
  15929.                            c:\> move myfile.dat a:\savefile.dat
  15930.  
  15931.                       In both cases, MYFILE.DAT is removed from drive C:
  15932.                       after it has been copied to drive A:.  If a file called
  15933.                       MYFILE.DAT in the first example, or SAVEFILE.DAT in the
  15934.                       second example, already existed on drive A:, it would
  15935.                       be overwritten.  (This demonstrates the difference
  15936.                       between MOVE and RENAME.  MOVE will move files between
  15937.                       drives and will overwrite the destination file if it
  15938.                       exists; RENAME will not.)
  15939.  
  15940.                       If you MOVE multiple files, the destination must be a
  15941.                       directory name.  MOVE will move each file into the
  15942.                       destination directory with its original name (if the
  15943.  
  15944.  
  15945.           ___________________________________________________________________
  15946.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  272
  15947.  
  15948.                                  CHAPTER 8 / COMMAND REFERENCE GUIDE  /  MOVE
  15949.           ___________________________________________________________________
  15950.  
  15951.  
  15952.                       target is not a directory, MOVE will display an error
  15953.                       message and exit):
  15954.  
  15955.                            c:\> move *.wks *.txt c:\finance\myfiles
  15956.  
  15957.                       You cannot move a file to a character device like the
  15958.                       printer, or to itself.
  15959.  
  15960.                   !   Be careful when you use MOVE with the SELECT command.
  15961.                       If you SELECT multiple files and if the target is not a
  15962.                       directory (because of a misspelling, for example) each
  15963.                       file will be moved in turn to the target file,
  15964.                       overwriting the previous file, and then the original
  15965.                       will be erased before the next file is moved.  At the
  15966.                       end of the command, all of the original files will have
  15967.                       been erased and only the last file will exist as the
  15968.                       target file.  You can avoid this problem by using
  15969.                       square brackets with SELECT instead of parentheses (be
  15970.                       sure that you don't allow the command line to get too
  15971.                       long -- watch the character count in the upper left
  15972.                       corner while you're selecting files).  MOVE will then
  15973.                       receive one list of files to move instead of a series
  15974.                       of individual filenames, and it will detect the error
  15975.                       and halt.  You can also add a backslash [\] to the end
  15976.                       of the destination name to ensure that it is the name
  15977.                       of a subdirectory (see below).
  15978.  
  15979.                       When you move files to another directory, if you add a
  15980.                       backslash [\] to the end of the destination name MOVE
  15981.                       will display an error message if the name does not
  15982.                       refer to an existing directory.  You can use this
  15983.                       feature to keep MOVE from treating a mistyped
  15984.                       destination directory name as a file name, and
  15985.                       attempting to move all source files to that name.  The
  15986.                       /D option performs the same function but will also
  15987.                       prompt to see if you want to create the destination
  15988.                       directory if it doesn't exist.  The /S option always
  15989.                       tries to create the destination directory if necessary,
  15990.                       so this feature will not be effective when /S is used.
  15991.  
  15992.                   ##  MOVE first attempts to rename the file(s), which is the
  15993.                       fastest way to move files between subdirectories on the
  15994.                       same drive.  If that fails (the destination is on a
  15995.                       different drive or already exists), MOVE will copy the
  15996.                       file(s) and then delete the originals.
  15997.  
  15998.                   ##  If you are using 4DOS in an OS/2 DOS session, MOVE will
  15999.                       copy OS/2 extended attributes from the source to the
  16000.  
  16001.  
  16002.           ___________________________________________________________________
  16003.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  273
  16004.  
  16005.                                  CHAPTER 8 / COMMAND REFERENCE GUIDE  /  MOVE
  16006.           ___________________________________________________________________
  16007.  
  16008.  
  16009.                       destination, provided the the file system on the
  16010.                       destination drive supports them.  You can disable this
  16011.                       feature with the CopyEA = No directive in 4DOS.INI (see
  16012.                       page 138).
  16013.  
  16014.           Options:    /C(hanged files):  Move files only if the destination
  16015.                       file exists and is older than the source (see also /U).
  16016.                       This option is useful for updating the files in one
  16017.                       directory from those in another without moving any
  16018.                       newly created files.
  16019.  
  16020.                       /D(irectory):  Requires that the destination be a
  16021.                       directory.  If the destination does not exist, MOVE
  16022.                       will prompt to see if you want to create it.  If the
  16023.                       destination exists as a file, MOVE will fail with an
  16024.                       "Access denied" error.  Use this option to avoid having
  16025.                       MOVE accidentally interpret your destination name as a
  16026.                       file name when it's really a mistyped directory name.
  16027.  
  16028.                   ##  /H(idden):  Move all files, including hidden and system
  16029.                       files.
  16030.  
  16031.                   ##  /N(othing):  Do everything except actually move the
  16032.                       file(s)   This option is most useful for testing what a
  16033.                       complex MOVE command will do.
  16034.  
  16035.                       /P(rompt):  Ask the user to confirm each move by
  16036.                       pressing Y or N.  An N response will skip that
  16037.                       particular file.
  16038.  
  16039.                       /Q(uiet):  Don't display filenames as they are moved.
  16040.  
  16041.                       /R(eplace):  Prompt for a Y or N response before
  16042.                       overwriting an existing destination file.
  16043.  
  16044.                   ##  /S(ubdirectories):  Move an entire subdirectory tree to
  16045.                       another location.  MOVE will attempt to create the
  16046.                       destination directories if they don't exist, and will
  16047.                       remove empty subdirectories after the move.  When /D is
  16048.                       used with /S, you will be prompted if the first
  16049.                       destination directory does not exist, but
  16050.                       subdirectories below that will be created automatically
  16051.                       by MOVE.  For example, the following alias will "graft"
  16052.                       a directory and all of its subdirectories into a new
  16053.                       place in the directory tree, and -- because /D is used
  16054.                       -- will prompt to see if you want to create the first
  16055.                       destination directory it if it doesn't exist.  The /H
  16056.  
  16057.  
  16058.  
  16059.           ___________________________________________________________________
  16060.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  274
  16061.  
  16062.                                  CHAPTER 8 / COMMAND REFERENCE GUIDE  /  MOVE
  16063.           ___________________________________________________________________
  16064.  
  16065.  
  16066.                       in this alias ensures that any hidden files and
  16067.                       subdirectories are also moved:
  16068.  
  16069.                            alias graft `move /s/d/h %1\*.* %2`
  16070.  
  16071.                       /U(pdate):  Move each source file only if it is newer
  16072.                       than a matching destination file or if a matching
  16073.                       destination file does not exist (also see /C).  This
  16074.                       option is useful for moving new files from one
  16075.                       directory to another.
  16076.  
  16077.  
  16078.  
  16079.  
  16080.  
  16081.  
  16082.  
  16083.  
  16084.  
  16085.  
  16086.  
  16087.  
  16088.  
  16089.  
  16090.  
  16091.  
  16092.  
  16093.  
  16094.  
  16095.  
  16096.  
  16097.  
  16098.  
  16099.  
  16100.  
  16101.  
  16102.  
  16103.  
  16104.  
  16105.  
  16106.  
  16107.  
  16108.  
  16109.  
  16110.  
  16111.  
  16112.  
  16113.  
  16114.  
  16115.  
  16116.           ___________________________________________________________________
  16117.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  275
  16118.  
  16119.                                  CHAPTER 8 / COMMAND REFERENCE GUIDE  /  PATH
  16120.           ___________________________________________________________________
  16121.  
  16122.  
  16123.           PATH                                                     (Enhanced)
  16124.  
  16125.           Purpose:    Display or alter the list of directories that 4DOS will
  16126.                       search for executable and batch files that are not in
  16127.                       the current directory.
  16128.  
  16129.           Format:     PATH [directory[;directory...]]
  16130.  
  16131.                       directory:  The full name of a directory to include in
  16132.                       the path setting.
  16133.  
  16134.                       See also: SET and ESET.
  16135.  
  16136.           Usage:      When 4DOS is asked to execute an external command (a
  16137.                       .COM, .EXE, .BTM, or .BAT file or executable
  16138.                       extension), it first looks for the file in the current
  16139.                       directory.  If it fails to find an executable file
  16140.                       there, it then searches each of the directories
  16141.                       specified in the path setting, in the order that they
  16142.                       are included.
  16143.  
  16144.                       For example, the following PATH command directs 4DOS to
  16145.                       search subdirectories for an executable file in the
  16146.                       following order: the current directory, the root
  16147.                       directory on C, the DOS subdirectory on C, and the UTIL
  16148.                       subdirectory on C:
  16149.  
  16150.                            c:\> path c:\;c:\dos;c:\util
  16151.  
  16152.                       The list of directories to search can be set or viewed
  16153.                       with the PATH command.  The list is stored as an
  16154.                       environment string, and can also be set or viewed with
  16155.                       the SET command and edited with the ESET command.
  16156.  
  16157.                       Directory names in the path must be separated by
  16158.                       semicolons [;].  4DOS shifts each directory name to
  16159.                       upper case.  This maintains compatibility with programs
  16160.                       which can only recognize upper case directory names in
  16161.                       the path variable.
  16162.  
  16163.                       If you modify your path with the SET or ESET command,
  16164.                       you may include directory names in lower case.  These
  16165.                       may cause trouble with some programs, which assume that
  16166.                       all path entries have been shifted to upper case.
  16167.  
  16168.                       If you enter PATH with no parameters, 4DOS displays the
  16169.                       current search path:
  16170.  
  16171.  
  16172.  
  16173.           ___________________________________________________________________
  16174.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  276
  16175.  
  16176.                                  CHAPTER 8 / COMMAND REFERENCE GUIDE  /  PATH
  16177.           ___________________________________________________________________
  16178.  
  16179.  
  16180.                            c:\> path
  16181.                            PATH=C:\;C:\DOS;C:\UTIL
  16182.  
  16183.                       If you enter PATH and a semicolon, 4DOS clears the
  16184.                       search path and will search only the current directory
  16185.                       (this is the default at system startup).
  16186.  
  16187.                       Some applications also use the PATH variable to search
  16188.                       for their data files.
  16189.  
  16190.                   ##  If you include an explicit file extension on the
  16191.                       external command name (for example, WP.EXE), 4DOS will
  16192.                       only look for files with that name and extension in the
  16193.                       current directory and every directory in the path
  16194.                       setting.  It will not look for other executable files
  16195.                       with the same base name.
  16196.  
  16197.                   ##  If you have a directory of a single period [.] in the
  16198.                       path, 4DOS will not search the current directory first,
  16199.                       but will wait and search the current directory when it
  16200.                       reaches the "." in the path.  This allows you to delay
  16201.                       (but not prevent) 4DOS's search of the current
  16202.                       directory for executable files and files with
  16203.                       executable extensions.  In rare cases, this feature may
  16204.                       not be compatible with applications which use the path
  16205.                       to search for their files; if you experience a problem,
  16206.                       you will have to remove the "." as a path entry while
  16207.                       using any such application.
  16208.  
  16209.                   ##  4DOS can create a PATH as long as 250 characters (the
  16210.                       command line is limited to 255 characters, and "PATH "
  16211.                       takes five).  Some applications are written to expect a
  16212.                       PATH no longer than the traditional limit of 123
  16213.                       characters.  If you have extended your path beyond the
  16214.                       traditional limit and experience unusual problems with
  16215.                       application programs, see page 162 for tips on
  16216.                       resolving the difficulty.
  16217.  
  16218.                   ##  If you specify an invalid directory in the path, 4DOS
  16219.                       will skip that directory and continue searching with
  16220.                       the next directory in the path.
  16221.  
  16222.  
  16223.  
  16224.  
  16225.  
  16226.  
  16227.  
  16228.  
  16229.  
  16230.           ___________________________________________________________________
  16231.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  277
  16232.  
  16233.                                 CHAPTER 8 / COMMAND REFERENCE GUIDE  /  PAUSE
  16234.           ___________________________________________________________________
  16235.  
  16236.  
  16237.           PAUSE                                                    (Enhanced)
  16238.  
  16239.           Purpose:    Suspend batch file or alias execution.
  16240.  
  16241.           Format:     PAUSE [text]
  16242.  
  16243.                       text:  The message to be displayed as a user prompt.
  16244.  
  16245.           Usage:      A PAUSE command will suspend execution of a batch file
  16246.                       or alias, giving you the opportunity to change disks,
  16247.                       turn on the printer, etc.
  16248.  
  16249.                       PAUSE waits for any key to be pressed and then
  16250.                       continues execution.  You can specify the text that
  16251.                       PAUSE displays while it waits for a keystroke, or let
  16252.                       4DOS use the default message:
  16253.  
  16254.                            Press any key when ready...
  16255.  
  16256.                       For example, the following batch file fragment prompts
  16257.                       the user before erasing files (the PAUSE command should
  16258.                       be entered on one line):
  16259.  
  16260.                            pause Press Ctrl-C to abort, any other key to
  16261.                              erase all .LST files
  16262.                            erase *.lst
  16263.  
  16264.                       If you press Ctrl-C or Ctrl-BREAK while PAUSE is
  16265.                       waiting for a key, execution of an alias will be
  16266.                       terminated, and execution of a batch file will be
  16267.                       suspended while you are asked whether you want to
  16268.                       cancel the batch job.
  16269.  
  16270.  
  16271.  
  16272.  
  16273.  
  16274.  
  16275.  
  16276.  
  16277.  
  16278.  
  16279.  
  16280.  
  16281.  
  16282.  
  16283.  
  16284.  
  16285.  
  16286.  
  16287.           ___________________________________________________________________
  16288.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  278
  16289.  
  16290.                                  CHAPTER 8 / COMMAND REFERENCE GUIDE  /  POPD
  16291.           ___________________________________________________________________
  16292.  
  16293.  
  16294.           POPD                                                          (New)
  16295.  
  16296.           Purpose:    Return to the disk drive and directory at the top of
  16297.                       the directory stack
  16298.  
  16299.           Format:     POPD [*]
  16300.  
  16301.                       See also: DIRS and PUSHD.
  16302.  
  16303.           Usage:      Each time you use the PUSHD command, 4DOS saves the
  16304.                       current disk drive and directory on its internal
  16305.                       directory stack.  POPD restores the last drive and
  16306.                       directory that was saved with PUSHD and removes that
  16307.                       entry from the stack.  You can use these commands
  16308.                       together to change directories, perform some work, and
  16309.                       return to the starting drive and directory.
  16310.  
  16311.                       This example saves and changes the current disk drive
  16312.                       and directory with PUSHD, and then restores it.  The
  16313.                       command line prompt is set to show the current
  16314.                       directory:
  16315.  
  16316.                            c:\> pushd d:\database\test
  16317.                            d:\database\test> pushd c:\wordp\memos
  16318.                            c:\wordp\memos> pushd a:\123
  16319.                            a:\123> popd
  16320.                            c:\wordp\memos> popd
  16321.                            d:\database\test> popd
  16322.                            c:\>
  16323.  
  16324.                       You can use the DIRS command to see the complete list
  16325.                       of saved drives and directories (the directory stack).
  16326.  
  16327.                       The POPD command followed by an asterisk [*] clears the
  16328.                       directory stack without changing the current drive and
  16329.                       directory.
  16330.  
  16331.                   ##  If the directory on the top of the stack is not on the
  16332.                       current drive, POPD will switch to the drive and
  16333.                       directory on the top of the stack without changing the
  16334.                       default directory on the current drive.
  16335.  
  16336.  
  16337.  
  16338.  
  16339.  
  16340.  
  16341.  
  16342.  
  16343.  
  16344.           ___________________________________________________________________
  16345.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  279
  16346.  
  16347.                                CHAPTER 8 / COMMAND REFERENCE GUIDE  /  PROMPT
  16348.           ___________________________________________________________________
  16349.  
  16350.  
  16351.           PROMPT                                                        (New)
  16352.  
  16353.           Purpose:    Change the 4DOS command line prompt.
  16354.  
  16355.           Format:     PROMPT [text]
  16356.  
  16357.                       text:  Text to be used as the 4DOS command line prompt.
  16358.  
  16359.           Usage:      You can change and customize the command line prompt at
  16360.                       any time.  The prompt can include normal text and
  16361.                       system information such as the current drive and
  16362.                       directory, the time and date, and the amount of memory
  16363.                       available.  You can create an informal "Hello, Bob!"
  16364.                       prompt or an official-looking prompt full of impressive
  16365.                       information.
  16366.  
  16367.                       The PROMPT command sets the command line prompt.  The
  16368.                       special characters that can be included in a PROMPT
  16369.                       command are listed below.  For example, to set the
  16370.                       prompt to the current date and time, with a ">" at the
  16371.                       end:
  16372.  
  16373.                            c:\> prompt $d $t $g
  16374.                            Mon  Dec 2, 1991 10:29:19 >
  16375.  
  16376.                       To set the prompt to the current date and time,
  16377.                       followed by the current drive and directory in upper
  16378.                       case on the next line, with a ">" at the end:
  16379.  
  16380.                            c:\> prompt $d $t$_$P$g
  16381.                            Mon  Dec 2, 1991 10:29:19
  16382.                            C:\>
  16383.  
  16384.                       You can include the PROMPT command in your AUTOEXEC.BAT
  16385.                       file to set the prompt whenever your system is
  16386.                       rebooted.
  16387.  
  16388.                       The default prompt is $n$g (drive name plus ">")  on
  16389.                       drives A and B, and $p$g (current drive and directory
  16390.                       plus ">") on all other drives .
  16391.  
  16392.                       If you enter PROMPT with no arguments, 4DOS resets the
  16393.                       prompt to the default.  The PROMPT command sets the
  16394.                       environment variable PROMPT, so to view the current
  16395.                       prompt setting use the command:
  16396.  
  16397.                            c:\> set prompt
  16398.  
  16399.  
  16400.  
  16401.           ___________________________________________________________________
  16402.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  280
  16403.  
  16404.                                CHAPTER 8 / COMMAND REFERENCE GUIDE  /  PROMPT
  16405.           ___________________________________________________________________
  16406.  
  16407.  
  16408.                       If the prompt is not set at all 4DOS will not use the
  16409.                       PROMPT environment variable, in which case the SET
  16410.                       command above will give a "Not in environment" error.
  16411.  
  16412.                   ##  Along with literal text, special characters, and ANSI
  16413.                       sequences, you can include the text of any environment
  16414.                       variable, 4DOS internal variable, or variable function
  16415.                       (see pages 81 and 85) in a prompt.  For example, if you
  16416.                       want to include the amount of free base memory in the
  16417.                       command prompt, plus the current drive and directory,
  16418.                       you could use this command:
  16419.  
  16420.                            c:\> prompt (%%@dosmem[K]K) $p$g
  16421.                            (601K) c:\data>
  16422.  
  16423.                       Notice that the @DOSMEM function is shown with two
  16424.                       leading percent signs [%].  If you used only one
  16425.                       percent sign, the @DOSMEM function would be expanded
  16426.                       once when the PROMPT command was executed, instead of
  16427.                       every time 4DOS displayed the prompt.  The result would
  16428.                       be that the amount of memory would never change from
  16429.                       the value it had when you entered the PROMPT command.
  16430.                       You could also use back quotes to delay expanding the
  16431.                       variable function until the prompt is displayed:
  16432.  
  16433.                            c:\> prompt `(%@dosmem[K]K) $p$g`
  16434.  
  16435.                   ##  If you have an ANSI-compatible driver installed, you
  16436.                       can include ANSI escape sequences in the PROMPT text.
  16437.                       This example uses ANSI sequences to set a prompt that
  16438.                       displays the shell level, date, time and path in color
  16439.                       on the top line of the screen (enter the command as one
  16440.                       line):
  16441.  
  16442.                            c:\> prompt $e[s$e[1;1f$e[41;1;37m$e[K[$z] $d
  16443.                                 Time: $t$h$h$h  Path: $p$e[u$e[0;32m$n$g
  16444.  
  16445.                   ##  Traditionally, it was possible to use the PROMPT
  16446.                       command in a batch file to transmit ANSI.SYS control
  16447.                       sequences to the screen (for example, to redefine
  16448.                       function keys).  This technique will not work with
  16449.                       4DOS, which doesn't display a prompt within batch
  16450.                       files; hence the characters in the PROMPT string are
  16451.                       never sent to ANSI.SYS.  To send ANSI sequences in
  16452.                       4DOS, use the ECHO command, substituting a Ctrl-X
  16453.                       followed by an e for $e in the PROMPT string.
  16454.  
  16455.  
  16456.  
  16457.  
  16458.           ___________________________________________________________________
  16459.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  281
  16460.  
  16461.                                CHAPTER 8 / COMMAND REFERENCE GUIDE  /  PROMPT
  16462.           ___________________________________________________________________
  16463.  
  16464.  
  16465.                   ##  You may find it helpful to define a different prompt in
  16466.                       secondary shells, by using $z to display the shell
  16467.                       level, or by placing a PROMPT command in your 4START
  16468.                       file and using IF or IFF statements to set the
  16469.                       appropriate prompt for different shells.
  16470.  
  16471.                       Prompt Characters:
  16472.  
  16473.                       The prompt text can contain special commands in the
  16474.                       form $?, where ? is one of the characters listed below.
  16475.  
  16476.                            b    The vertical bar character [|]
  16477.                            c    The open parenthesis [(]
  16478.                            D    Current date, in the format:  Tue  Jan 1,
  16479.                                    1991
  16480.                            d    Current date, in the format:  Tue  1-01-91
  16481.                            e    The ASCII ESC character (decimal 27)
  16482.                            f    The close parenthesis [)]
  16483.                            g    The > character
  16484.                            h    BACKSPACE over the previous character
  16485.                            l    The < character
  16486.                            n    Current disk letter
  16487.                            P    Current disk and directory (upper case)
  16488.                            p    Current disk and directory (lower case)
  16489.                            q    The = character
  16490.                            r    The numeric exit code of the last external
  16491.                                    command
  16492.                            s    The space character
  16493.                            t    Current time, in the format hh:mm:ss
  16494.                            v    DOS version number, in the format 3.10
  16495.                            Xd:  Current directory on drive d:, in upper case
  16496.                            xd:  Current directory on drive d:, in lower case
  16497.                            z    Current 4DOS shell nesting level; the
  16498.                                    primary command processor is shell 0.
  16499.                            $    The $ character
  16500.                            _    CR/LF (go to beginning of a new line)
  16501.  
  16502.                   ##  The format for the date ($d) depends on the country
  16503.                       code defined in the CONFIG.SYS file or by the CHCP
  16504.                       command.  The default format is U.S. (mm-dd-yy).  The
  16505.                       European format is dd-mm-yy; the Japanese is yy-mm-dd.
  16506.                       The separator used for the time ($t) will also be
  16507.                       changed based on the country definition.
  16508.  
  16509.  
  16510.  
  16511.  
  16512.  
  16513.  
  16514.  
  16515.           ___________________________________________________________________
  16516.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  282
  16517.  
  16518.                                 CHAPTER 8 / COMMAND REFERENCE GUIDE  /  PUSHD
  16519.           ___________________________________________________________________
  16520.  
  16521.  
  16522.           PUSHD                                                         (New)
  16523.  
  16524.           Purpose:    Save the current disk drive and directory, optionally
  16525.                       moving to a new drive and directory.
  16526.  
  16527.           Format:     PUSHD [pathname]
  16528.  
  16529.                       pathname:  The name of the new default drive and
  16530.                       directory.
  16531.  
  16532.                       See also: DIRS, POPD and CDPATH on page 117.
  16533.  
  16534.           Usage:      PUSHD saves the current drive and directory on a "last
  16535.                       in, first out" directory stack.  The POPD command
  16536.                       returns to the last drive and directory that was saved
  16537.                       by PUSHD.  You can use these commands together to
  16538.                       change directories, perform some work, and return to
  16539.                       the starting drive and directory.
  16540.  
  16541.                       The DIRS command displays the contents of the directory
  16542.                       stack.
  16543.  
  16544.                       To save the current drive and directory, without
  16545.                       changing directories:
  16546.  
  16547.                            c:\> pushd
  16548.                            c:\>
  16549.  
  16550.                       If a pathname is specified as part of the PUSHD
  16551.                       command, the current drive and directory are saved and
  16552.                       the specified pathname becomes the new current drive
  16553.                       and directory.  If the pathname includes a drive
  16554.                       letter, PUSHD changes to the specified directory on the
  16555.                       new drive without changing the default current
  16556.                       directory on the original drive.
  16557.  
  16558.                       This example saves the current directory and changes to
  16559.                       C:\WORDP\MEMOS, then returns to the original directory
  16560.                       with POPD:
  16561.  
  16562.                            c:\> pushd \wordp\memos
  16563.                            c:\wordp\memos> popd
  16564.                            c:\>
  16565.  
  16566.                   ##  The directory stack can hold up to 255 characters or
  16567.                       about 10 to 20 entries depending on the length of the
  16568.                       directory names.  If you exceed the directory stack
  16569.  
  16570.  
  16571.  
  16572.           ___________________________________________________________________
  16573.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  283
  16574.  
  16575.                                 CHAPTER 8 / COMMAND REFERENCE GUIDE  /  PUSHD
  16576.           ___________________________________________________________________
  16577.  
  16578.  
  16579.                       size, the oldest directory is removed before adding the
  16580.                       current directory.
  16581.  
  16582.                   ##  If PUSHD can't change to the specified directory, it
  16583.                       will look for the CDPATH environment variable.  PUSHD
  16584.                       will append the specified directory name to each
  16585.                       directory in CDPATH and attempt to change to that drive
  16586.                       and directory, until the first match or the end of the
  16587.                       CDPATH argument.  This allows you to use CDPATH as a
  16588.                       quick way to find commonly used subdirectories which
  16589.                       have unique names.  For example, if you are currently
  16590.                       in the directory C:\WP\LETTERS\JANUARY and you'd like
  16591.                       to change to D:\SOFTWARE\UTIL, you could enter the
  16592.                       command:
  16593.  
  16594.                            c:\wp\letters\january> pushd d:\software\util
  16595.  
  16596.                       However if the D:\SOFTWARE directory is listed in your
  16597.                       CDPATH variable, and is the first directory in the list
  16598.                       with a UTIL subdirectory, you can simply enter the
  16599.                       command:
  16600.  
  16601.                            c:\wp\letters\january> pushd util
  16602.  
  16603.                       and 4DOS will change to D:\SOFTWARE\UTIL.
  16604.  
  16605.  
  16606.  
  16607.  
  16608.  
  16609.  
  16610.  
  16611.  
  16612.  
  16613.  
  16614.  
  16615.  
  16616.  
  16617.  
  16618.  
  16619.  
  16620.  
  16621.  
  16622.  
  16623.  
  16624.  
  16625.  
  16626.  
  16627.  
  16628.  
  16629.           ___________________________________________________________________
  16630.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  284
  16631.  
  16632.                                  CHAPTER 8 / COMMAND REFERENCE GUIDE  /  QUIT
  16633.           ___________________________________________________________________
  16634.  
  16635.  
  16636.           QUIT                                                          (New)
  16637.  
  16638.           Purpose:    Terminate the current batch file.
  16639.  
  16640.           Format:     QUIT [value]
  16641.  
  16642.                       value:  The exit code from 0 to 255 to return to 4DOS
  16643.                       or to the previous batch file.
  16644.  
  16645.                       See also: CANCEL.
  16646.  
  16647.           Usage:      QUIT provides a simple way to exit a batch file before
  16648.                       reaching the end of the file.  If you QUIT a batch file
  16649.                       called from another batch file, you will be returned to
  16650.                       the previous file at the line following the original
  16651.                       call.
  16652.  
  16653.                       This example batch file fragment checks to see if the
  16654.                       user entered "quit" and exits if true.
  16655.  
  16656.                            input  Enter your choice :  %%option
  16657.                            if  "%option" == "quit"  quit
  16658.  
  16659.                       To end all batch file processing, use the CANCEL
  16660.                       command.
  16661.  
  16662.                   ##  If you specify a value, QUIT will set the ERRORLEVEL or
  16663.                       exit code (see the IF command, and the %? variable on
  16664.                       page 81) to that value.
  16665.  
  16666.                   ##  You can also use QUIT in an alias.  If you QUIT an
  16667.                       alias while inside a batch file, QUIT will end both the
  16668.                       alias and the batch file and return you to the 4DOS
  16669.                       command prompt or to the calling batch file.
  16670.  
  16671.  
  16672.  
  16673.  
  16674.  
  16675.  
  16676.  
  16677.  
  16678.  
  16679.  
  16680.  
  16681.  
  16682.  
  16683.  
  16684.  
  16685.  
  16686.           ___________________________________________________________________
  16687.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  285
  16688.  
  16689.                            CHAPTER 8 / COMMAND REFERENCE GUIDE  /  RD / RMDIR
  16690.           ___________________________________________________________________
  16691.  
  16692.  
  16693.           RD / RMDIR                                               (Enhanced)
  16694.  
  16695.           Purpose:    Remove one or more subdirectories.
  16696.  
  16697.           Format:     RD pathname...
  16698.                            or
  16699.                       RMDIR pathname...
  16700.  
  16701.                       pathname:  The name of a subdirectory to remove.
  16702.  
  16703.                       See also: MD.
  16704.  
  16705.           Usage:      RD and RMDIR are synonyms.  You can use either one.
  16706.  
  16707.                       RD removes directories from the directory tree.  For
  16708.                       example, to remove the subdirectory MEMOS from the
  16709.                       subdirectory WP, you can use this command:
  16710.  
  16711.                            c:\> rd \wp\memos
  16712.  
  16713.                       Before using RD, you must delete all files and
  16714.                       subdirectories (and their files) in the pathname you
  16715.                       want to remove.  Remember to remove hidden and read-
  16716.                       only files as well as normal files.
  16717.  
  16718.                   ##  To use a single command to remove entire subdirectory
  16719.                       trees including all files, see the /S and /X options of
  16720.                       the DEL command.
  16721.  
  16722.                   ##  You cannot remove the root directory, the current
  16723.                       directory (.), or any directory above the current
  16724.                       directory in the directory tree.
  16725.  
  16726.                   ##  You can use wildcards in the pathname.
  16727.  
  16728.  
  16729.  
  16730.  
  16731.  
  16732.  
  16733.  
  16734.  
  16735.  
  16736.  
  16737.  
  16738.  
  16739.  
  16740.  
  16741.  
  16742.  
  16743.           ___________________________________________________________________
  16744.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  286
  16745.  
  16746.                                CHAPTER 8 / COMMAND REFERENCE GUIDE  /  REBOOT
  16747.           ___________________________________________________________________
  16748.  
  16749.  
  16750.           REBOOT                                                        (New)
  16751.  
  16752.           Purpose:    Do a warm or cold system reboot.
  16753.  
  16754.           Format:     REBOOT [/C /V]
  16755.  
  16756.                       /C(old reboot)              /V(erify)
  16757.  
  16758.           ## Usage:   REBOOT will completely restart your computer.  It is
  16759.                       comparable to pressing Ctrl-Alt-Delete (a warm reboot)
  16760.                       or to turning the power off and back on or pressing the
  16761.                       reset button (a cold reboot).  A reboot is necessary to
  16762.                       activate any changes to your CONFIG.SYS file, and may
  16763.                       also be used if you wish to restart the system with an
  16764.                       altered 4START or AUTOEXEC.BAT file.
  16765.  
  16766.                       The following example prompts you to verify the reboot,
  16767.                       then does a cold boot:
  16768.  
  16769.                            c:\> reboot /c/v
  16770.  
  16771.                       REBOOT defaults to performing a warm boot, with no
  16772.                       prompting.
  16773.  
  16774.                       REBOOT flushes the disk buffers, resets the drives, and
  16775.                       waits one second before rebooting, to allow disk
  16776.                       caching programs to finish writing any cached data .
  16777.  
  16778.                   !   Some system BIOSes, memory managers, multitaskers, or
  16779.                       memory-resident programs (TSRs) may intercept attempts
  16780.                       to reboot your system, and defeat them entirely,
  16781.                       convert a cold boot request to a warm boot or vice
  16782.                       versa, or in very rare cases, hang the system --
  16783.                       requiring a reboot!  As a result you may need to
  16784.                       experiment with which reboot options work best for your
  16785.                       system hardware and software configuration, and under
  16786.                       rare circumstances REBOOT may not be useable on your
  16787.                       system.
  16788.  
  16789.           Options:    /C(old):  Do a "cold" reboot.  This is similar to
  16790.                       turning the power off and back on, and may be necessary
  16791.                       to properly initialize the system.  REBOOT /C may not
  16792.                       physically reset all hardware devices as thoroughly as
  16793.                       actually turning off the power; its effect depends on
  16794.                       the internal design of each hardware device and on your
  16795.                       system configuration.
  16796.  
  16797.  
  16798.  
  16799.  
  16800.           ___________________________________________________________________
  16801.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  287
  16802.  
  16803.                                CHAPTER 8 / COMMAND REFERENCE GUIDE  /  REBOOT
  16804.           ___________________________________________________________________
  16805.  
  16806.  
  16807.                       /V(erify):  Prompt for confirmation (Y or N) before
  16808.                       rebooting.
  16809.  
  16810.  
  16811.  
  16812.  
  16813.  
  16814.  
  16815.  
  16816.  
  16817.  
  16818.  
  16819.  
  16820.  
  16821.  
  16822.  
  16823.  
  16824.  
  16825.  
  16826.  
  16827.  
  16828.  
  16829.  
  16830.  
  16831.  
  16832.  
  16833.  
  16834.  
  16835.  
  16836.  
  16837.  
  16838.  
  16839.  
  16840.  
  16841.  
  16842.  
  16843.  
  16844.  
  16845.  
  16846.  
  16847.  
  16848.  
  16849.  
  16850.  
  16851.  
  16852.  
  16853.  
  16854.  
  16855.  
  16856.  
  16857.           ___________________________________________________________________
  16858.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  288
  16859.  
  16860.                                   CHAPTER 8 / COMMAND REFERENCE GUIDE  /  REM
  16861.           ___________________________________________________________________
  16862.  
  16863.  
  16864.           REM                                                    (Compatible)
  16865.  
  16866.           Purpose:    Put a comment in a batch file.
  16867.  
  16868.           Format:     REM [comment]
  16869.  
  16870.                       comment:  The text to include in the batch file.
  16871.  
  16872.           Usage:      The REM command lets you place a remark or comment in a
  16873.                       batch file.  Batch file comments are useful for
  16874.                       documenting the purpose of a batch file and the
  16875.                       procedures you have used.  For example
  16876.  
  16877.                            rem This batch file provides a
  16878.                            rem menu-based system for accessing
  16879.                            rem word processing utilities.
  16880.                            rem
  16881.                            rem Clear the screen and get selection
  16882.                            cls
  16883.  
  16884.                       REM must be followed by a space or tab character and
  16885.                       then your comment.  Comments can be up to 255
  16886.                       characters long.  4DOS will ignore everything on the
  16887.                       line after the REM command (including quote characters,
  16888.                       redirection symbols, and other commands).
  16889.  
  16890.                       If ECHO is ON, 4DOS will display the comment.
  16891.                       Otherwise, 4DOS will ignore it.
  16892.  
  16893.                       If ECHO is ON and you don't want to display the line,
  16894.                       preface the REM command with the @ character.
  16895.  
  16896.  
  16897.  
  16898.  
  16899.  
  16900.  
  16901.  
  16902.  
  16903.  
  16904.  
  16905.  
  16906.  
  16907.  
  16908.  
  16909.  
  16910.  
  16911.  
  16912.  
  16913.  
  16914.           ___________________________________________________________________
  16915.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  289
  16916.  
  16917.                          CHAPTER 8 / COMMAND REFERENCE GUIDE  /  REN / RENAME
  16918.           ___________________________________________________________________
  16919.  
  16920.  
  16921.           REN / RENAME                                             (Enhanced)
  16922.  
  16923.           Purpose:    Rename files or subdirectories.
  16924.  
  16925.           Format:     REN [/N /P /Q /S] old_name... new_name
  16926.                            or
  16927.                       RENAME [/N /P /Q /S] old_name... new_name
  16928.  
  16929.                       old_name:  Original name of the file(s) or
  16930.                       subdirectory.
  16931.                       new_name:  New name to use or new path on the same
  16932.                       drive.
  16933.  
  16934.                       /N(othing)                  /Q(uiet)
  16935.                       /P(rompt)                   /S(ubdirectory)
  16936.  
  16937.                       See Also: COPY and MOVE.
  16938.  
  16939.           Usage:      REN and RENAME are synonyms.  You may use either one.
  16940.  
  16941.                       REN lets you change the name of a file or a
  16942.                       subdirectory.  You can also use REN to move one or more
  16943.                       files to a new subdirectory on the same drive.  (If you
  16944.                       want to move files to a different drive, use MOVE.)
  16945.  
  16946.                       In its simplest form, you simply give REN the old_name
  16947.                       of an existing file or subdirectory and then a
  16948.                       new_name.  The new_name must not already exist -- you
  16949.                       can't give two files the same name (unless they are in
  16950.                       different directories).  The first example renames the
  16951.                       file MEMO.TXT to OFFICE.TXT.  The second example
  16952.                       changes the name of the \WORDPROC directory to \WP:
  16953.  
  16954.                            c:\> rename memo.txt office.txt
  16955.                            c:\> rename \wordproc \wp
  16956.  
  16957.                       You can also use REN to rename a group of files that
  16958.                       you specify with wildcards, as multiple files, or in an
  16959.                       include list.  When you do, the new_name must use one
  16960.                       or more wildcards to show what part of each filename to
  16961.                       change.  Both of the next two examples change the
  16962.                       extensions of multiple files to .SAV:
  16963.  
  16964.                            c:\> ren config.sys autoexec.bat 4start.btm *.sav
  16965.                            c:\> ren *.txt *.sav
  16966.  
  16967.                       REN can move one or more files to a different
  16968.                       subdirectory on the same drive.  When it is used for
  16969.  
  16970.  
  16971.           ___________________________________________________________________
  16972.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  290
  16973.  
  16974.                          CHAPTER 8 / COMMAND REFERENCE GUIDE  /  REN / RENAME
  16975.           ___________________________________________________________________
  16976.  
  16977.  
  16978.                       this purpose, REN requires one or more filenames for
  16979.                       the old_name and a directory name for the new_name:
  16980.  
  16981.                            c:\> ren memo.txt c:\wp\memos\
  16982.                            c:\> ren oct.dat nov.dat c:\data\save\
  16983.  
  16984.                       The final backslash in the last two examples is
  16985.                       optional.  If you use it, you force REN to recognize
  16986.                       the last argument as the name of a directory, not a
  16987.                       file.  If you accidentally mistype the directory name,
  16988.                       REN will report an error instead of renaming your files
  16989.                       in a way that you didn't intend.
  16990.  
  16991.                       Finally, REN can move files to a new directory and
  16992.                       change their name at the same time if you specify both
  16993.                       a path and file name for new_name.  In this example,
  16994.                       the files are renamed with an extension of .SAV as they
  16995.                       are moved to a new directory:
  16996.  
  16997.                            c:\> ren *.dat c:\data\save\*.sav
  16998.  
  16999.                       When new_name refers to a file or files (rather than a
  17000.                       directory), the file(s) must not already exist.  Also,
  17001.                       you cannot rename a subdirectory to a new location on
  17002.                       the directory tree.
  17003.  
  17004.                   ##  REN does not change a file's attributes.  The new_name
  17005.                       file(s) will have the same attributes as old_name.
  17006.  
  17007.           Options:    /N(othing):  Do everything except actually rename the
  17008.                       file(s).  This option is useful for testing what a REN
  17009.                       command will actually do.
  17010.  
  17011.                       /P(rompt):  Ask the user to confirm each move by
  17012.                       pressing Y or N.  An N response will skip that
  17013.                       particular file.
  17014.  
  17015.                       /Q(uiet):  Don't display filenames as they are renamed.
  17016.                       This option is most often used in batch files.
  17017.  
  17018.                       /S(ubdirectory):  Normally, you can rename a
  17019.                       subdirectory only if you do not use any wildcards in
  17020.                       the old_name.  This prevents subdirectories from being
  17021.                       renamed inadvertently when a group of files is being
  17022.                       renamed with wildcards.  /S will let you rename a
  17023.                       subdirectory even when you use wildcards.
  17024.  
  17025.  
  17026.  
  17027.  
  17028.           ___________________________________________________________________
  17029.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  291
  17030.  
  17031.                                CHAPTER 8 / COMMAND REFERENCE GUIDE  /  RETURN
  17032.           ___________________________________________________________________
  17033.  
  17034.  
  17035.           RETURN                                                        (New)
  17036.  
  17037.           Purpose:    Return from a GOSUB (subroutine) in a batch file.
  17038.  
  17039.           Format:     RETURN
  17040.  
  17041.                       See also: GOSUB.
  17042.  
  17043.           ## Usage:   4DOS allows subroutines in batch files.  A subroutine
  17044.                       begins with a label (a colon followed by a word) and
  17045.                       ends with a RETURN command.  The subroutine is invoked
  17046.                       with a GOSUB command from another part of the batch
  17047.                       file.  The RETURN command ends a subroutine; execution
  17048.                       of the batch file will continue on the line following
  17049.                       the original GOSUB.
  17050.  
  17051.                       The following batch file fragment calls a subroutine
  17052.                       which displays the current directory:
  17053.  
  17054.                            echo Calling a subroutine
  17055.                            gosub subr1
  17056.                            echo Returned from the subroutine
  17057.                            quit
  17058.  
  17059.                            :subr1
  17060.                            dir /a/w
  17061.                            return
  17062.  
  17063.  
  17064.  
  17065.  
  17066.  
  17067.  
  17068.  
  17069.  
  17070.  
  17071.  
  17072.  
  17073.  
  17074.  
  17075.  
  17076.  
  17077.  
  17078.  
  17079.  
  17080.  
  17081.  
  17082.  
  17083.  
  17084.  
  17085.           ___________________________________________________________________
  17086.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  292
  17087.  
  17088.                                CHAPTER 8 / COMMAND REFERENCE GUIDE  /  SCREEN
  17089.           ___________________________________________________________________
  17090.  
  17091.  
  17092.           SCREEN                                                        (New)
  17093.  
  17094.           Purpose:    Position the cursor on the screen and optionally
  17095.                       display a message.
  17096.  
  17097.           Format:     SCREEN row column [message]
  17098.  
  17099.                       row:  The new row location for the cursor.
  17100.                       column:  The new column location for the cursor.
  17101.                       message:  Optional text to display at the new cursor
  17102.                       location.
  17103.  
  17104.                       See also: ECHO, SCRPUT, TEXT, and VSCRPUT.
  17105.  
  17106.           Usage:      SCREEN allows you to create attractive screen displays
  17107.                       in batch files.  You use it to specify where a message
  17108.                       will appear on the screen.  You can use SCREEN to
  17109.                       create menu displays, logos, etc.  The following batch
  17110.                       file fragment displays a menu:
  17111.  
  17112.                            @echo off ^ cls
  17113.                            screen 3 10  Select a number from 1 to 4:
  17114.                            screen 6 20  1 - Word Processing
  17115.                            screen 7 20  2 - Spreadsheet
  17116.                            screen 8 20  3 - Telecommunications
  17117.                            screen 9 20  4 - Quit
  17118.  
  17119.                       SCREEN does not change the screen colors.  If you have
  17120.                       ANSI.SYS installed and have set colors with CLS or
  17121.                       COLOR, those colors will be used for the display.  To
  17122.                       display text in specific colors, use SCRPUT or VSCRPUT.
  17123.  
  17124.                       The row and column values are zero-based, so on a
  17125.                       standard 25 line by 80 column display, valid rows are 0
  17126.                       - 24 and valid columns are 0 - 79.
  17127.  
  17128.                       SCREEN checks for a valid row and column, and displays
  17129.                       a "Usage" error message if either value is out of
  17130.                       range.
  17131.  
  17132.  
  17133.  
  17134.  
  17135.  
  17136.  
  17137.  
  17138.  
  17139.  
  17140.  
  17141.  
  17142.           ___________________________________________________________________
  17143.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  293
  17144.  
  17145.                                CHAPTER 8 / COMMAND REFERENCE GUIDE  /  SCRPUT
  17146.           ___________________________________________________________________
  17147.  
  17148.  
  17149.           SCRPUT                                                        (New)
  17150.  
  17151.           Purpose:    Position the cursor on the screen and display a message
  17152.                       in color.
  17153.  
  17154.           Format:     SCRPUT row col [BRIght] [BLInk] fg ON [BRIght] bg text
  17155.  
  17156.                       row:  Starting row
  17157.                       col:  Starting column
  17158.                       fg:  Foreground character color
  17159.                       bg:  Background character color
  17160.                       text:  The text to display
  17161.  
  17162.                       The available colors are:
  17163.  
  17164.                         Black         Blue          Green         Red
  17165.                         Magenta       Cyan          Yellow        White
  17166.  
  17167.                       See also: CLS, ECHO, SCREEN, TEXT, and VSCRPUT.
  17168.  
  17169.           Usage:      SCRPUT allows you to create attractive screen displays
  17170.                       in batch files.  You use it to specify where a message
  17171.                       will appear on the screen and what colors will be used
  17172.                       to display the message text.  You can use SCRPUT to
  17173.                       create menu displays, logos, etc.
  17174.  
  17175.                       SCRPUT works like SCREEN, but allows you to specify the
  17176.                       display colors.  It writes directly to the screen and
  17177.                       does not require an ANSI driver.
  17178.  
  17179.                       Only the first three characters of the color name and
  17180.                       the attributes BRIGHT and BLINK are required.  Bright
  17181.                       backgrounds will not work unless BrightBG is set to Yes
  17182.                       in 4DOS.INI (see page 129).  The row and column are
  17183.                       zero-based, so on a standard 25 line by 80 column
  17184.                       display, valid rows are 0 - 24 and valid columns are
  17185.                       0 - 79.
  17186.  
  17187.                       The following batch file fragment displays a menu in
  17188.                       color (each  SCRPUT command should be entered on one
  17189.                       line):
  17190.  
  17191.                            @echo off ^ cls white on blue
  17192.                            scrput 3 10 bri whi on blue Select a number from
  17193.                              1 to 4:
  17194.                            scrput 6 20 bri red on blue 1 - Word Processing
  17195.                            scrput 7 20 bri yel on blue 2 - Spreadsheet
  17196.  
  17197.  
  17198.  
  17199.           ___________________________________________________________________
  17200.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  294
  17201.  
  17202.                                CHAPTER 8 / COMMAND REFERENCE GUIDE  /  SCRPUT
  17203.           ___________________________________________________________________
  17204.  
  17205.  
  17206.                            scrput 8 20 bri gre on blue 3 -
  17207.                            Telecommunications
  17208.                            scrput 9 20 bri mag on blue 4 - Quit
  17209.  
  17210.  
  17211.  
  17212.  
  17213.  
  17214.  
  17215.  
  17216.  
  17217.  
  17218.  
  17219.  
  17220.  
  17221.  
  17222.  
  17223.  
  17224.  
  17225.  
  17226.  
  17227.  
  17228.  
  17229.  
  17230.  
  17231.  
  17232.  
  17233.  
  17234.  
  17235.  
  17236.  
  17237.  
  17238.  
  17239.  
  17240.  
  17241.  
  17242.  
  17243.  
  17244.  
  17245.  
  17246.  
  17247.  
  17248.  
  17249.  
  17250.  
  17251.  
  17252.  
  17253.  
  17254.  
  17255.  
  17256.           ___________________________________________________________________
  17257.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  295
  17258.  
  17259.                                CHAPTER 8 / COMMAND REFERENCE GUIDE  /  SELECT
  17260.           ___________________________________________________________________
  17261.  
  17262.  
  17263.           SELECT                                                        (New)
  17264.  
  17265.           Purpose:    Interactively select files for a command.
  17266.  
  17267.           Format:     SELECT [/A[[:][-][rhsda]] /C[H] /D /E
  17268.                            /O[:][-]adeginrsu] [command] ... (files...)...
  17269.  
  17270.                       command:  The command to execute with the selected
  17271.                       files.
  17272.                       files:  The files from which to select.  File names may
  17273.                       be enclosed in either parentheses or square brackets.
  17274.                       The difference is explained below.
  17275.  
  17276.                       /A(ttribute select)         /E  (upper case)
  17277.                       /C[H] (compression ratios)  /O(rder)
  17278.                       /D(isable colorization)
  17279.  
  17280.           Usage:      SELECT allows you to select files for internal and
  17281.                       external commands by using a full-screen "point and
  17282.                       shoot" display.  You can have SELECT execute a command
  17283.                       once for each file you select, or have it create a list
  17284.                       of files for a command to work with.  The command can
  17285.                       be a 4DOS internal command or alias, an external
  17286.                       command, or a batch file.
  17287.  
  17288.                       If you use parentheses around the files, SELECT
  17289.                       executes the command once for each file you have
  17290.                       selected.  During each execution, one of the selected
  17291.                       files is passed to the command as an argument.  If you
  17292.                       use square brackets around files, the SELECTed files
  17293.                       are combined into a single list, separated by spaces.
  17294.                       The command is then executed once with the entire list
  17295.                       presented as its command-line arguments.
  17296.  
  17297.                       SELECT uses the cursor up, cursor down, PgUp, and PgDn
  17298.                       keys to scroll through the file list.  Use the + key or
  17299.                       the spacebar to select a file (or unselect a marked
  17300.                       file), and the - key to unselect a file.  The * key
  17301.                       will reverse all of the current marks (excluding
  17302.                       subdirectories), and the / key will unmark everything.
  17303.                       After marking the files, press Enter to execute the
  17304.                       command.
  17305.  
  17306.                       You can select a single file by moving the scroll bar
  17307.                       to the filename and pressing Enter without marking any
  17308.                       other files.
  17309.  
  17310.  
  17311.  
  17312.  
  17313.           ___________________________________________________________________
  17314.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  296
  17315.  
  17316.                                CHAPTER 8 / COMMAND REFERENCE GUIDE  /  SELECT
  17317.           ___________________________________________________________________
  17318.  
  17319.  
  17320.                       To skip the files listed in the current display and go
  17321.                       on to the next file specification inside the
  17322.                       parentheses or brackets (if any), press the Escape key.
  17323.                       To cancel the current SELECT command entirely, press
  17324.                       Ctrl-C or Ctrl-Break.
  17325.  
  17326.                       In the simplest form of SELECT, you merely specify the
  17327.                       command and then the list of files from which you will
  17328.                       make your selection(s).  For example:
  17329.  
  17330.                            c:\> select copy (*.com *.exe) a:\
  17331.  
  17332.                       will let you select from among the .COM and .EXE files
  17333.                       on the current drive.  It will then invoke the COPY
  17334.                       command to copy each file you select to drive A:.  You
  17335.                       will be able to select first from a list of all .COM
  17336.                       files in the current directory, and then from a list of
  17337.                       all .EXE files.
  17338.  
  17339.                       If you want to select from a list of all the .COM and
  17340.                       .EXE files mixed together, create an include list
  17341.                       inside the parentheses by inserting a semi-colon (see
  17342.                       page 74 for information on include lists):
  17343.  
  17344.                            c:\> select copy (*.com;*.exe) a:\
  17345.  
  17346.                       Finally, if you want the SELECT command to send a
  17347.                       single list of files to COPY, instead of invoking COPY
  17348.                       once for each file you select, put the file names in
  17349.                       square brackets instead of parentheses:
  17350.  
  17351.                            c:\> select copy [*.com;*.exe] a:\
  17352.  
  17353.                       If you use brackets, you have to be sure that the
  17354.                       resulting command (the word COPY, the list of files,
  17355.                       and the destination drive in this example) is no more
  17356.                       than 127 characters long for external commands and no
  17357.                       more than 255 characters long for internal 4DOS
  17358.                       commands.  The current line length is displayed by
  17359.                       SELECT while you are marking files to help you to
  17360.                       conform to these limits.
  17361.  
  17362.                       The parentheses or brackets enclosing the file name(s)
  17363.                       can appear anywhere within the command; SELECT assumes
  17364.                       that the first set of parentheses or brackets it finds
  17365.                       is the one containing the list of files from which you
  17366.                       wish to make your selection.
  17367.  
  17368.  
  17369.  
  17370.           ___________________________________________________________________
  17371.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  297
  17372.  
  17373.                                CHAPTER 8 / COMMAND REFERENCE GUIDE  /  SELECT
  17374.           ___________________________________________________________________
  17375.  
  17376.  
  17377.                       SELECT can display and sort by file compression ratios
  17378.                       on MS-DOS 6.0 DBLSPACE drives.  Use the /C or /CH
  17379.                       switch to display compression ratios in place of file
  17380.                       descriptions.  Use /O:c to sort the display by
  17381.                       compression ratio.  Compression ratios will be
  17382.                       displayed automatically if /O:c is used, whether or not
  17383.                       /C or /CH is specified.
  17384.  
  17385.                   ##  If you don't specify a command, the selected
  17386.                       filename(s) will become the command.  For example, this
  17387.                       command defines an alias called UTILS that selects from
  17388.                       the executable files in the directory C:\UTIL, and then
  17389.                       executes them in the order marked (enter the alias on
  17390.                       one line):
  17391.  
  17392.                            c:\> alias utils select
  17393.                                  (c:\util\*.com;*.exe;*.btm;*.bat)
  17394.  
  17395.                   ##  If you want to use filename completion (see page 59) to
  17396.                       enter the filenames inside the parentheses, type a
  17397.                       space after the opening parenthesis.  Otherwise the
  17398.                       command line editor will treat the open parenthesis as
  17399.                       the first character of the filename.
  17400.  
  17401.                   ##  You can set the default colors used by SELECT (and
  17402.                       LIST) using the ListColors directive in 4DOS.INI (see
  17403.                       page 132).  If ListColors is not used, the default
  17404.                       colors will be set by the StdColors directive (page
  17405.                       133) or by the last CLS or COLOR command.
  17406.  
  17407.                   ##  If you have an ANSI driver loaded, you can display the
  17408.                       filenames in color by setting the COLORDIR environment
  17409.                       variable (the same colors will be used by the DIR
  17410.                       command).  The format for COLORDIR is:
  17411.  
  17412.                            ext ... :[BRIght][BLInk] fg [ON [BRIght] bg]; ...
  17413.  
  17414.                       where ext is the file extension, or one of the
  17415.                       following file attributes:
  17416.  
  17417.                            DIRS      directory
  17418.                            RDONLY    read-only file
  17419.                            HIDDEN    hidden file
  17420.                            SYSTEM    system file
  17421.                            ARCHIVE   file modified since last backup.
  17422.  
  17423.  
  17424.  
  17425.  
  17426.  
  17427.           ___________________________________________________________________
  17428.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  298
  17429.  
  17430.                                CHAPTER 8 / COMMAND REFERENCE GUIDE  /  SELECT
  17431.           ___________________________________________________________________
  17432.  
  17433.  
  17434.                       For example, to display the .COM and .EXE files in red,
  17435.                       the .C and .ASM files in bright cyan, and the read-only
  17436.                       files in blinking green (enter this on one line):
  17437.  
  17438.                            c:\> set colordir=com exe:red; c asm:bright cyan;
  17439.                                 rdonly:blink green
  17440.  
  17441.                       If you don't specify a background color, SELECT will
  17442.                       use the current screen background color from the
  17443.                       ListColors or StdColors directive or the last CLS or
  17444.                       COLOR command (as described above).  COLORDIR will not
  17445.                       work properly unless you have an ANSI driver loaded.
  17446.                       Bright backgrounds will not work unless BrightBG is set
  17447.                       to Yes in 4DOS.INI (see page 129).
  17448.  
  17449.                       You can disable directory colorization within SELECT
  17450.                       with the /D option.
  17451.  
  17452.                       When displaying file descriptions, SELECT adds a right
  17453.                       arrow at the end of the line if the description is too
  17454.                       long to fit on the screen.  This symbol will alert you
  17455.                       to the existence of additional description text.
  17456.  
  17457.                   ##  Extended wildcards (for example "BA[KXC]" for .BAK,
  17458.                       .BAX, and .BAC files) can be used in directory color
  17459.                       specifications.  See page 71 for more information on
  17460.                       extended wildcards.
  17461.  
  17462.                   ##  When sorting file names and extensions for the SELECT
  17463.                       display, 4DOS normally assumes that sequences of digits
  17464.                       should be sorted numerically (for example, the file
  17465.                       DRAW2 would come before DRAW03 because 2 is numerically
  17466.                       larger than 03), rather than strictly alphabetically
  17467.                       (where DRAW2 would come second because "2" is more than
  17468.                       "0").  You can defeat this behavior and force a strict
  17469.                       alphabetic sort with the /O:a option.
  17470.  
  17471.                   ##  You may need to increase 4DOS's internal stack size
  17472.                       using the StackSize directive in 4DOS.INI if you use
  17473.                       extremely complex combinations of commands like EXCEPT,
  17474.                       FOR, GLOBAL, IF, and SELECT on the same command line,
  17475.                       or use complex combinations of these commands in nested
  17476.                       batch files or nested GOSUBs.  See the StackSize
  17477.                       directive on page 141 for more information.
  17478.  
  17479.           Options:##  /A(ttribute select):  Display only those files that
  17480.                       have the specified attribute set.  Preceding the
  17481.                       attribute character with a minus [-] will display those
  17482.  
  17483.  
  17484.           ___________________________________________________________________
  17485.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  299
  17486.  
  17487.                                CHAPTER 8 / COMMAND REFERENCE GUIDE  /  SELECT
  17488.           ___________________________________________________________________
  17489.  
  17490.  
  17491.                       files that DON'T have that attribute set.  Attributes
  17492.                       can also be combined.  The attributes are:
  17493.  
  17494.                            R    Read-only         D    Subdirectory
  17495.                            H    Hidden            A    Archive
  17496.                            S    System
  17497.  
  17498.                       If no attributes are listed at all (e.g. SELECT /A
  17499.                       ...), SELECT will display all files and subdirectories
  17500.                       including hidden and system files.  If attributes are
  17501.                       combined, all the specified attributes must match for a
  17502.                       file to be included in the listing.  For example,
  17503.                       /A:RHS will display only those files with all three
  17504.                       attributes set.  See page 182 for more information on
  17505.                       file attributes.
  17506.  
  17507.                       /C(ompression ratios):  Display per-file and total
  17508.                       compression ratios on drives compressed with MS-DOS
  17509.                       6.0's DBLSPACE disk compression utility.  The
  17510.                       compression ratio is displayed instead of the file
  17511.                       description.  The ratio is left blank for directories
  17512.                       and files with length 0, and for files on non-DBLSPACE
  17513.                       drives.
  17514.  
  17515.                       The numerator for the displayed compression ratio is
  17516.                       the amount of space which would be allocated to the
  17517.                       file on the DBLSPACE drive if it were not compressed,
  17518.                       using the DBLSPACE drive's cluster size (normally 8K
  17519.                       bytes).  The denominator is the space actually
  17520.                       allocated to the file after compression.
  17521.  
  17522.                       /CH:  Display compression ratios like /C, but base the
  17523.                       calculation on the host drive's cluster size.  This
  17524.                       gives a more accurate picture of the space saved
  17525.                       through compression than is given by /C.  Please note
  17526.                       that /CH will occasionally display compression ratios
  17527.                       slightly less than 1.0 to 1.0.  This reflects files
  17528.                       which have actually expanded when stored on the
  17529.                       DBLSPACE drive.  COMMAND.COM may display these ratios
  17530.                       as 1.0 to 1.0, even if the true ratio is slightly less.
  17531.                       4DOS always displays the true ratio.
  17532.  
  17533.                   ##  /D(isable colorization):  Temporarily turn off
  17534.                       directory colorization within SELECT.
  17535.  
  17536.                       /E (upper case):  Display filenames in the traditional
  17537.                       upper case format; also see SETDOS /U and the UpperCase
  17538.                       directive in 4DOS.INI.
  17539.  
  17540.  
  17541.           ___________________________________________________________________
  17542.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  300
  17543.  
  17544.                                CHAPTER 8 / COMMAND REFERENCE GUIDE  /  SELECT
  17545.           ___________________________________________________________________
  17546.  
  17547.  
  17548.                       /O(rder):  Set the sort order for the files.  The order
  17549.                       can be any combination of the following options:
  17550.  
  17551.                            -    Reverse the sort order for the next option
  17552.                            a    Sort names and extensions in standard ASCII
  17553.                                 order, rather than sorting numerically when
  17554.                                 digits are included in the name or extension
  17555.                            c    Sort by DBLSPACE compression ratio; also
  17556.                                 implies /C
  17557.                            d    Sort by date and time (oldest first)
  17558.                            e    Sort by extension
  17559.                            g    Group subdirectories together
  17560.                            i    Sort by the file description
  17561.                            n    Sort by filename (this is the default)
  17562.                            r    Reverse the sort order for all options
  17563.                            s    Sort by size
  17564.                            u    Unsorted
  17565.  
  17566.  
  17567.  
  17568.  
  17569.  
  17570.  
  17571.  
  17572.  
  17573.  
  17574.  
  17575.  
  17576.  
  17577.  
  17578.  
  17579.  
  17580.  
  17581.  
  17582.  
  17583.  
  17584.  
  17585.  
  17586.  
  17587.  
  17588.  
  17589.  
  17590.  
  17591.  
  17592.  
  17593.  
  17594.  
  17595.  
  17596.  
  17597.  
  17598.           ___________________________________________________________________
  17599.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  301
  17600.  
  17601.                                   CHAPTER 8 / COMMAND REFERENCE GUIDE  /  SET
  17602.           ___________________________________________________________________
  17603.  
  17604.  
  17605.           SET                                                      (Enhanced)
  17606.  
  17607.           Purpose:    Display, create, modify, or delete environment
  17608.                       variables.
  17609.  
  17610.           Format:     SET [/M /P /R filename...] [name[=][value]]
  17611.  
  17612.                       filename:  The name of a file containing variable
  17613.                       definitions.
  17614.                       name:  The name of the environment variable to define
  17615.                       or modify.
  17616.                       value:  The new value for the variable.
  17617.  
  17618.                       /M(aster)                   /R(ead from file)
  17619.                       /P(ause)
  17620.  
  17621.                       See also: UNSET and ESET.
  17622.  
  17623.           Usage:      Every program and command inherits an environment,
  17624.                       which is a list of variable names, each of which is
  17625.                       followed by an equal sign and some text.  Many programs
  17626.                       use entries in the environment to modify their own
  17627.                       actions.  4DOS itself uses several environment
  17628.                       variables (see page 116).  See page 78 for more
  17629.                       information on the environment.
  17630.  
  17631.                       If you simply type the SET command with no options or
  17632.                       arguments, it will display all the names and values
  17633.                       currently stored in the environment.  Typically, you
  17634.                       will see an entry called COMSPEC, an entry called PATH,
  17635.                       an entry called CMDLINE, and whatever other environment
  17636.                       variables you and your programs have established:
  17637.  
  17638.                            c:\> set
  17639.                            COMSPEC=C:\4DOS.COM
  17640.                            PATH=C:\;C:\DOS;C:\UTIL
  17641.                            CMDLINE=E:\UTIL\MAPMEM.EXE
  17642.  
  17643.                       To add a variable to the environment, type SET plus the
  17644.                       variable name, an equal sign, and the text:
  17645.  
  17646.                            c:\> set mine=c:\finance\myfiles
  17647.  
  17648.                       4DOS will convert the variable name to upper case but
  17649.                       leave the text after the equal sign just as you entered
  17650.                       it.  If the variable already exists, its value will be
  17651.                       replaced with the new text that you entered.
  17652.  
  17653.  
  17654.  
  17655.           ___________________________________________________________________
  17656.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  302
  17657.  
  17658.                                   CHAPTER 8 / COMMAND REFERENCE GUIDE  /  SET
  17659.           ___________________________________________________________________
  17660.  
  17661.  
  17662.                       Normally you should not put a space on either side of
  17663.                       the equal sign.  A space before the equal sign will
  17664.                       become part of the name; a space after the equal sign
  17665.                       will become part of the value.
  17666.  
  17667.                       To display the contents of a single variable, type SET
  17668.                       plus the variable name:
  17669.  
  17670.                            c:\> set mine
  17671.  
  17672.                       You can edit environment variables with the ESET
  17673.                       command.  To remove variables from the environment, use
  17674.                       UNSET, or type SET plus a variable name and an equal
  17675.                       sign:
  17676.  
  17677.                            c:\> set mine=
  17678.  
  17679.                       4DOS limits the variable name to a maximum of 80
  17680.                       characters, and the name plus the value to a maximum of
  17681.                       255 characters.
  17682.  
  17683.                   ##  Unless you use /M, SET only affects the environment of
  17684.                       the current command processor and the programs it
  17685.                       executes.  If you EXIT to a parent command processor,
  17686.                       the original environment will be unchanged.
  17687.  
  17688.                       The size of the environment is specified by the
  17689.                       Environment and EnvFree directives in 4DOS.INI (see
  17690.                       page 126) or by the /E: startup switch (see page 111).
  17691.  
  17692.           Options:##  /M(aster):  Display or modify the master environment
  17693.                       rather than the local environment.  This option only
  17694.                       makes sense in a secondary command processor.
  17695.  
  17696.                       /P(ause):  Pause after displaying each page of
  17697.                       environment entries.  Press Ctrl-C to quit, or any
  17698.                       other key to display the next page.
  17699.  
  17700.                   ##  /R(ead):  Read environment variables from a file.  This
  17701.                       is much faster than loading variables from a batch file
  17702.                       with multiple SET commands.  The file is in the same
  17703.                       format as the SET display, so SET /R can accept as
  17704.                       input a file generated by redirecting SET output.  For
  17705.                       example, the following commands will save the
  17706.                       environment variables to a file, and then reload them
  17707.                       from that file:
  17708.  
  17709.                                 set > varlist
  17710.  
  17711.  
  17712.           ___________________________________________________________________
  17713.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  303
  17714.  
  17715.                                   CHAPTER 8 / COMMAND REFERENCE GUIDE  /  SET
  17716.           ___________________________________________________________________
  17717.  
  17718.  
  17719.                                 set /r varlist
  17720.  
  17721.                       You can load variables from multiple files by listing
  17722.                       the filenames individually after the /R.  You can add
  17723.                       comments to a variable file by starting the comment
  17724.                       line with a colon [:].  Lines in a SET /R file can be
  17725.                       up to 511 characters long.
  17726.  
  17727.  
  17728.  
  17729.  
  17730.  
  17731.  
  17732.  
  17733.  
  17734.  
  17735.  
  17736.  
  17737.  
  17738.  
  17739.  
  17740.  
  17741.  
  17742.  
  17743.  
  17744.  
  17745.  
  17746.  
  17747.  
  17748.  
  17749.  
  17750.  
  17751.  
  17752.  
  17753.  
  17754.  
  17755.  
  17756.  
  17757.  
  17758.  
  17759.  
  17760.  
  17761.  
  17762.  
  17763.  
  17764.  
  17765.  
  17766.  
  17767.  
  17768.  
  17769.           ___________________________________________________________________
  17770.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  304
  17771.  
  17772.                                CHAPTER 8 / COMMAND REFERENCE GUIDE  /  SETDOS
  17773.           ___________________________________________________________________
  17774.  
  17775.  
  17776.           SETDOS                                                        (New)
  17777.  
  17778.           Purpose:    Display or set the 4DOS configuration.
  17779.  
  17780.           Format:     SETDOS [/A? /C? /E? /I+|- command /L? /M? /N? /R? /S?:?
  17781.                            /U? /V?]
  17782.  
  17783.                       /A(NSI)                     /N(o clobber)
  17784.                       /C(ompound)                 /P(arameter character)
  17785.                       /E(scape character)         /R(ows)
  17786.                       /I(nternal commands)        /S(hape of cursor)
  17787.                       /L(ine)                     /U(pper case)
  17788.                       /M(ode for editing)         /V(erbose)
  17789.  
  17790.           Usage:      SETDOS allows you to customize certain aspects of 4DOS
  17791.                       to suit your personal tastes or the configuration of
  17792.                       your system.  Each of these options is described below.
  17793.  
  17794.                       You can display the value of all SETDOS options by
  17795.                       entering the SETDOS command with no parameters.
  17796.  
  17797.                       Most of the SETDOS options can be initialized when 4DOS
  17798.                       starts through directives in the 4DOS.INI file (see
  17799.                       page 129).  The name of the corresponding directive is
  17800.                       listed in square brackets [ ] with each option;  if
  17801.                       none is listed, that option cannot be set from the
  17802.                       4DOS.INI file.  You can also define the SETDOS options
  17803.                       in your AUTOEXEC.BAT or 4START file, in aliases, or at
  17804.                       the command line.
  17805.  
  17806.                       Secondary shells automatically inherit most
  17807.                       configuration settings currently in effect in the
  17808.                       previous shell.  If values have been changed by SETDOS
  17809.                       since 4DOS started, the new values will be passed to
  17810.                       the secondary shell.  For details on inheritance of
  17811.                       SETDOS values by secondary shells and their
  17812.                       relationship to 4DOS.INI, see page 121.
  17813.  
  17814.                       SETDOS /I settings are not inherited by secondary
  17815.                       shells.  If you want to use SETDOS /I- to disable
  17816.                       commands in all shells, place the SETDOS command(s) in
  17817.                       your 4START file (see page 118), which is executed when
  17818.                       any shell starts.
  17819.  
  17820.                       Many of the options below are marked with## .  If you
  17821.                       are a new user, skip these and read the /M, /S, and /U
  17822.                       options, which are more common.
  17823.  
  17824.  
  17825.  
  17826.           ___________________________________________________________________
  17827.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  305
  17828.  
  17829.                                CHAPTER 8 / COMMAND REFERENCE GUIDE  /  SETDOS
  17830.           ___________________________________________________________________
  17831.  
  17832.  
  17833.           Options:##  /A(NSI)  [ANSI]:  The ANSI option determines whether
  17834.                       4DOS will attempt to use ANSI escape sequences for the
  17835.                       CLS and COLOR commands.  4DOS normally determines this
  17836.                       itself, but if you are using a non-standard ANSI driver
  17837.                       or your loading sequence is unusual, you may need to
  17838.                       explicitly inform 4DOS.  /A0 allows 4DOS to determine
  17839.                       whether an ANSI driver is installed (the default).
  17840.                       /A1 forces 4DOS to assume an ANSI driver is installed.
  17841.                       /A2 forces 4DOS to assume an ANSI driver is not
  17842.                       installed.
  17843.  
  17844.                   ##  /C(ompound character)  [CommandSep]:  The COMPOUND
  17845.                       option sets the character used for separating multiple
  17846.                       commands on the same line.  The default is the caret
  17847.                       [^].  You cannot use any of the redirection characters
  17848.                       (| > <), or any of the whitespace characters (blank,
  17849.                       tab, comma, or equal sign) as the command separator.
  17850.                       This example changes the COMPOUND character to a tilde
  17851.                       [~]:
  17852.  
  17853.                            c:\> setdos /c~
  17854.  
  17855.                   ##  /E(scape character)  [EscapeChar]:  The ESCAPE option
  17856.                       sets the character used to suppress the normal meaning
  17857.                       of the following character.  Any character following
  17858.                       the escape character will be passed unmodified to the
  17859.                       command line.  For example, you could include a
  17860.                       redirection character such as > as part of a command-
  17861.                       line argument if the character was preceded by the
  17862.                       escape character.  The default escape character is
  17863.                       Ctrl-X (ASCII 24; appears on screen as an up-arrow).
  17864.                       You cannot use any of the redirection characters (| >
  17865.                       <) or the whitespace characters (blank, tab, comma, or
  17866.                       equal sign) as the escape character.  Certain
  17867.                       characters (b, e, f, n, r, and t)  have special
  17868.                       meanings when immediately preceded by the escape
  17869.                       character.  See page 94 for additional details.
  17870.  
  17871.                   ##  /I(nternal):  The INTERNAL option allows you to disable
  17872.                       or enable internal 4DOS commands.  To disable a
  17873.                       command, precede the command name with a minus [-].  To
  17874.                       re-enable a command, precede it with a plus [+].  For
  17875.                       example, to disable the internal LIST command to force
  17876.                       4DOS to use an external command:
  17877.  
  17878.                            c:\> setdos /i-list
  17879.  
  17880.  
  17881.  
  17882.  
  17883.           ___________________________________________________________________
  17884.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  306
  17885.  
  17886.                                CHAPTER 8 / COMMAND REFERENCE GUIDE  /  SETDOS
  17887.           ___________________________________________________________________
  17888.  
  17889.  
  17890.                   ##  /L(ine)  [LineInput]:  The LINE option controls how
  17891.                       4DOS gets its input from the command line.  /L0 tells
  17892.                       4DOS to use character input (the default).  /L1 tells
  17893.                       4DOS to use line input (via DOS  service INT 21h
  17894.                       function 0Ah, like COMMAND.COM).  /L1 will disable
  17895.                       command line editing, history recall, and filename
  17896.                       completion; it should only be used if it is needed for
  17897.                       compatibility with a specific program.  If you have a
  17898.                       program that requires line input, you can use the
  17899.                       following line in an alias or batch file to change the
  17900.                       line input option just for that single program:
  17901.  
  17902.                            setdos /L1 ^ program %& ^ setdos /L0
  17903.  
  17904.                       See the file APPNOTES.DOC for information on programs
  17905.                       which require this option.
  17906.  
  17907.                       /M(ode)  [EditMode]:  The MODE option controls the
  17908.                       initial line editing mode.  /M0 forces 4DOS to start
  17909.                       editing in overstrike mode (the default).  /M1 forces
  17910.                       4DOS to start editing in insert mode.
  17911.  
  17912.                   ##  /N(o clobber)  [NoClobber]:  The NOCLOBBER option
  17913.                       controls output redirection (see page 66).  /N0 means
  17914.                       existing files will be overwritten by simple
  17915.                       redirection (with >) and that appending (with >>) does
  17916.                       not require the file to exist already.  This is the
  17917.                       default.  /N1 means existing files may not be
  17918.                       overwritten by simple output redirection, and that when
  17919.                       appending the output file must exist.  A /N1 setting
  17920.                       can be overridden with the [!] character.  If you use
  17921.                       /N1, you may have problems with a few unusual programs
  17922.                       that shell to DOS to run a command with redirection,
  17923.                       and expect to be able to overwrite an existing file.
  17924.  
  17925.                   ##  /P(arameter character)  [ParameterChar]:   This option
  17926.                       sets the character used to specify all or all remaining
  17927.                       command line arguments.  The default is '&' (as in
  17928.                       "%&") for 4DOS and '$' (as in "%$") for 4OS2.  Use
  17929.                       SETDOS /P$ to set the 4DOS character to match 4OS2.
  17930.  
  17931.                   ##  /R(ows)  [ScreenRows]:  The ROWS option sets the number
  17932.                       of screen rows used by the video display.  Normally
  17933.                       4DOS detects the screen size, but if you have a non-
  17934.                       standard display you may need to set it explicitly.
  17935.                       This option does not affect screen scrolling (that is
  17936.                       controlled by your video BIOS or ANSI.SYS); it is used
  17937.                       only for LIST, SELECT, the paged output options (i.e.,
  17938.  
  17939.  
  17940.           ___________________________________________________________________
  17941.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  307
  17942.  
  17943.                                CHAPTER 8 / COMMAND REFERENCE GUIDE  /  SETDOS
  17944.           ___________________________________________________________________
  17945.  
  17946.  
  17947.                       TYPE /P), and error checking in the screen output
  17948.                       commands.
  17949.  
  17950.                       /S(hape)  [CursorOver, CursorIns]:  The SHAPE option
  17951.                       sets the 4DOS cursor shape.  The format is /So:i where
  17952.                       o is the cursor size for overstrike mode, i the cursor
  17953.                       size for insert mode.  The size is entered as a
  17954.                       percentage of the total character height.  The default
  17955.                       values are 10:100 (an underscore cursor for overstrike
  17956.                       mode, and a block cursor for insert mode).  Because of
  17957.                       the way video BIOSes remap the cursor shape, you may
  17958.                       not get a smooth progression in the cursor size from 0%
  17959.                       - 100%.  To disable the cursor, enter /S0:0.
  17960.  
  17961.                       /U(pper)  [UpperCase]:  The UPPER option controls the
  17962.                       default case (upper or lower) for filenames displayed
  17963.                       by 4DOS internal commands like COPY and DIR.  /U0
  17964.                       displays file names in lower case (the default).  /U1
  17965.                       displays file names in the traditional upper case.
  17966.  
  17967.                   ##  /V(erbose)  [BatchEcho]:  The VERBOSE option controls
  17968.                       the default for command echoing in batch files.  /V0
  17969.                       disables echoing of batch file commands unless ECHO is
  17970.                       explicitly set ON.  /V1 enables echoing of batch file
  17971.                       commands unless ECHO is explicitly set OFF.  /V2 forces
  17972.                       echoing of all batch file commands, even if ECHO is set
  17973.                       OFF or the line begins with an "@".  /V2 is intended
  17974.                       for debugging, and can be set with SETDOS but cannot be
  17975.                       set with the BatchEcho directive in 4DOS.INI.  /V1 is
  17976.                       the default.
  17977.  
  17978.  
  17979.  
  17980.  
  17981.  
  17982.  
  17983.  
  17984.  
  17985.  
  17986.  
  17987.  
  17988.  
  17989.  
  17990.  
  17991.  
  17992.  
  17993.  
  17994.  
  17995.  
  17996.  
  17997.           ___________________________________________________________________
  17998.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  308
  17999.  
  18000.                              CHAPTER 8 / COMMAND REFERENCE GUIDE  /  SETLOCAL
  18001.           ___________________________________________________________________
  18002.  
  18003.  
  18004.           SETLOCAL                                                      (New)
  18005.  
  18006.           Purpose:    Save a copy of the current disk drive, directory,
  18007.                       environment, and alias list.
  18008.  
  18009.           Format:     SETLOCAL
  18010.  
  18011.                       See also: ENDLOCAL.
  18012.  
  18013.           Usage:      SETLOCAL is used in batch files to save the default
  18014.                       disk drive and directory, the environment, and the
  18015.                       alias list to a reserved block of memory.  You can then
  18016.                       change their values and later restore the original
  18017.                       values with the ENDLOCAL command.
  18018.  
  18019.                       For example, this batch file fragment saves everything,
  18020.                       changes the disk and directory, modifies some
  18021.                       variables, runs a program, and then restores the
  18022.                       original values:
  18023.  
  18024.                            setlocal
  18025.                            cdd d:\test
  18026.                            set path=c:\;c:\dos;c:\util
  18027.                            set lib=d:\lib
  18028.                            rem run some program here
  18029.                            endlocal
  18030.  
  18031.                       SETLOCAL and ENDLOCAL are not nestable within a batch
  18032.                       file.  However, you can have multiple SETLOCAL /
  18033.                       ENDLOCAL pairs within a batch file, and nested batch
  18034.                       files can each have their own SETLOCAL / ENDLOCAL.  You
  18035.                       cannot use SETLOCAL in an alias or at the command line.
  18036.  
  18037.                   ##  4DOS automatically performs an ENDLOCAL at the end of a
  18038.                       batch file if you forget to do so.  If you invoke one
  18039.                       batch file from another without using CALL, the first
  18040.                       batch file is terminated, and an automatic ENDLOCAL is
  18041.                       performed.  The second batch file inherits the drive,
  18042.                       directory, aliases, and environment variables as they
  18043.                       were prior to any unterminated SETLOCAL.
  18044.  
  18045.                   ##  Do not load memory-resident programs (TSRs) from a
  18046.                       batch file while SETLOCAL is in effect.  If you do,
  18047.                       when ENDLOCAL is executed and the memory used by
  18048.                       SETLOCAL is released, a "hole" will be left in memory
  18049.                       below the TSR.  This is not usually harmful, but wastes
  18050.                       memory.
  18051.  
  18052.  
  18053.  
  18054.           ___________________________________________________________________
  18055.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  309
  18056.  
  18057.                                 CHAPTER 8 / COMMAND REFERENCE GUIDE  /  SHIFT
  18058.           ___________________________________________________________________
  18059.  
  18060.  
  18061.           SHIFT                                                    (Enhanced)
  18062.  
  18063.           Purpose:    Allows the use of more than 127 replaceable parameters
  18064.                       in a batch file.
  18065.  
  18066.           Format:     SHIFT [n]
  18067.  
  18068.           Usage:      SHIFT is provided for compatibility with older batch
  18069.                       files, where it was used to access more than 10
  18070.                       replaceable parameters.  4DOS supports 128 replaceable
  18071.                       parameters (%0 to %127), so you may not need to use
  18072.                       SHIFT for batch files running exclusively under 4DOS.
  18073.  
  18074.                       SHIFT moves each of the batch file replaceable
  18075.                       parameters n positions to the left.  The default value
  18076.                       for n is 1.  SHIFT 1 moves the parameter in %1 to
  18077.                       position %0, the parameter in %2 becomes %1, etc.  You
  18078.                       can reverse a SHIFT by giving a negative value for n
  18079.                       (i.e., after SHIFT -1, the former %0 is restored, %0
  18080.                       becomes %1, %1 becomes %2, etc.).
  18081.  
  18082.                       SHIFT also affects the 4DOS parameters %n& (command
  18083.                       line tail) and %# (number of command arguments).
  18084.  
  18085.                       For example, create a batch file called TEST.BAT:
  18086.  
  18087.                            echo %1 %2 %3 %4
  18088.                            shift
  18089.                            echo %1 %2 %3 %4
  18090.                            shift 2
  18091.                            echo %1 %2 %3 %4
  18092.                            shift -1
  18093.                            echo %1 %2 %3 %4
  18094.  
  18095.                       Executing TEST.BAT produces the following results:
  18096.  
  18097.                            c:\> test zero one two three four five six
  18098.  
  18099.                            zero one two three
  18100.                            one two three four
  18101.                            three four five six
  18102.                            two three four five
  18103.  
  18104.  
  18105.  
  18106.  
  18107.  
  18108.  
  18109.  
  18110.  
  18111.           ___________________________________________________________________
  18112.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  310
  18113.  
  18114.                              CHAPTER 8 / COMMAND REFERENCE GUIDE  /  SWAPPING
  18115.           ___________________________________________________________________
  18116.  
  18117.  
  18118.           SWAPPING                                                      (New)
  18119.  
  18120.           Purpose:    Enable or disable 4DOS swapping, or display the
  18121.                       swapping state.
  18122.  
  18123.           Format:     SWAPPING [ON | OFF]
  18124.  
  18125.           ## Usage:   SWAPPING temporarily disables or enables the swapping
  18126.                       of the transient portion of 4DOS to EMS expanded
  18127.                       memory, to XMS extended memory, or to disk (see page
  18128.                       126).
  18129.  
  18130.                       Setting SWAPPING OFF is particularly useful for
  18131.                       speeding up batch files (including AUTOEXEC.BAT) when
  18132.                       4DOS is using disk swapping.  When you are running
  18133.                       several small programs from a batch file, disk swapping
  18134.                       can sometimes cause a noticeable delay.  However, if
  18135.                       you disable swapping, there will be about 92K less
  18136.                       memory available for large application programs.
  18137.  
  18138.                       The following batch file fragment disables swapping,
  18139.                       runs several programs, and then re-enables swapping:
  18140.  
  18141.                            swapping off
  18142.                            c:\util\mouse
  18143.                            c:\video\ansi.com
  18144.                            cls bright white on blue
  18145.                            c:\bin\cache.com
  18146.                            swapping on
  18147.  
  18148.                       If you enter SWAPPING with no arguments, 4DOS displays
  18149.                       the current swapping type (XMS, EMS, Disk, or None) and
  18150.                       state:
  18151.  
  18152.                            c:\> swapping
  18153.                            SWAPPING (XMS) is ON
  18154.  
  18155.                       Setting SWAPPING OFF does not close the disk swap file
  18156.                       or release any reserved EMS or XMS memory.
  18157.  
  18158.                       You may have trouble if you load memory-resident
  18159.                       programs (TSRs) with SWAPPING OFF and unload them with
  18160.                       SWAPPING ON, or vice versa.  Many TSRs expect the
  18161.                       system to be in the same state when they unload that it
  18162.                       was in when they loaded, and variation from this norm
  18163.                       may cause the TSR to unload improperly or hang your
  18164.                       system, requiring a reboot.
  18165.  
  18166.  
  18167.  
  18168.           ___________________________________________________________________
  18169.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  311
  18170.  
  18171.                                   CHAPTER 8 / COMMAND REFERENCE GUIDE  /  TEE
  18172.           ___________________________________________________________________
  18173.  
  18174.  
  18175.           TEE                                                           (New)
  18176.  
  18177.           Purpose:    Copy standard input to both standard output and a file.
  18178.  
  18179.           Format:     TEE [/A] file...
  18180.  
  18181.                       file:  One or more files that will receive the "tee-d"
  18182.                       output.
  18183.  
  18184.                       /A(ppend)
  18185.  
  18186.                       See also: Y; redirection options (page 66).
  18187.  
  18188.           ## Usage:   Many programs get their input from "standard input" and
  18189.                       send their output to "standard output," which are
  18190.                       normally the keyboard and video display (known
  18191.                       collectively as the console or CON).  You can redirect
  18192.                       both the input and output of such programs, for
  18193.                       example, using a file either to provide the input or
  18194.                       collect the output.
  18195.  
  18196.                       TEE gets its input from standard input and sends out
  18197.                       two copies: one goes to standard output, the other to
  18198.                       the file or files that you specify.  It is most often
  18199.                       used with a redirection pipe [|] to capture
  18200.                       intermediate output before the data is altered by
  18201.                       another program or command.
  18202.  
  18203.                       For example, to search the file DOC for any lines
  18204.                       containing the string "4DOS", make a copy of the
  18205.                       matching lines in 4.DAT, sort the lines, and write them
  18206.                       to the output file 4D.DAT:
  18207.  
  18208.                            c:\> find "4DOS" doc | tee 4.dat | sort > 4d.dat
  18209.  
  18210.                       If you are typing at the keyboard to produce the input
  18211.                       for TEE, you must enter a Ctrl-Z to terminate the
  18212.                       input.
  18213.  
  18214.           Option:     /A(ppend):  Add the output to the file(s) rather than
  18215.                       overwriting them.
  18216.  
  18217.  
  18218.  
  18219.  
  18220.  
  18221.  
  18222.  
  18223.  
  18224.  
  18225.           ___________________________________________________________________
  18226.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  312
  18227.  
  18228.                                  CHAPTER 8 / COMMAND REFERENCE GUIDE  /  TEXT
  18229.           ___________________________________________________________________
  18230.  
  18231.  
  18232.           TEXT                                                          (New)
  18233.  
  18234.           Purpose:    Display a block of text in a batch file.
  18235.  
  18236.           Format:     TEXT
  18237.                            .
  18238.                            .
  18239.                            .
  18240.                       ENDTEXT
  18241.  
  18242.                       See also: ECHO, SCREEN, SCRPUT, and VSCRPUT.
  18243.  
  18244.           Usage:      The TEXT command is useful for displaying menus or
  18245.                       multi-line messages from a batch file.  TEXT will
  18246.                       display all subsequent lines in the batch file until
  18247.                       terminated by ENDTEXT.  Both TEXT and ENDTEXT must be
  18248.                       entered as the only command on the line.
  18249.  
  18250.                       If you have an ANSI driver loaded, you can change
  18251.                       screen colors by inserting ANSI escape sequences
  18252.                       anywhere in the text block.  You can also use a CLS or
  18253.                       COLOR command to set the screen color before executing
  18254.                       the TEXT command.
  18255.  
  18256.                       The following batch file fragment displays a simple
  18257.                       menu:
  18258.  
  18259.                            @echo off ^ cls ^ screen 2 0
  18260.                            text
  18261.                            Enter one of the following:
  18262.                            1 - Spreadsheet
  18263.                            2 - Word Processing
  18264.                            3 - DOS Utilities
  18265.                            Enter your selection :
  18266.                            endtext
  18267.  
  18268.  
  18269.  
  18270.  
  18271.  
  18272.  
  18273.  
  18274.  
  18275.  
  18276.  
  18277.  
  18278.  
  18279.  
  18280.  
  18281.  
  18282.           ___________________________________________________________________
  18283.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  313
  18284.  
  18285.                                  CHAPTER 8 / COMMAND REFERENCE GUIDE  /  TIME
  18286.           ___________________________________________________________________
  18287.  
  18288.  
  18289.           TIME                                                   (Compatible)
  18290.  
  18291.           Purpose:    Display or set the current system time.
  18292.  
  18293.           Format:     TIME [hh[:mm[:ss]]] [AM | PM]
  18294.  
  18295.                       hh   hour,  0 - 23
  18296.                       mm   minute,  0 - 59
  18297.                       ss   second,  0 - 59
  18298.  
  18299.                       See also: CHCP and DATE.
  18300.  
  18301.           Usage:      If you don't enter any parameters, TIME will display
  18302.                       the current system time and prompt you for a new time.
  18303.                       Press ENTER if you don't wish to change the time;
  18304.                       otherwise, enter the new time:
  18305.  
  18306.                            c:\> time
  18307.                            Mon  Dec 2, 1991  9:30:10
  18308.                            New time (hh:mm:ss):
  18309.  
  18310.                       TIME defaults to 24-hour format, but you can optionally
  18311.                       enter the time in 12-hour format by appending an "am"
  18312.                       or "pm" to the time you enter.
  18313.  
  18314.                       For example, to enter the time as 9:30 am:
  18315.  
  18316.                            c:\> time 9:30 am
  18317.  
  18318.                       DOS adds the system time and date to the directory
  18319.                       entry of every file you create and modify.  If you keep
  18320.                       both the time and date accurate, you will have a record
  18321.                       of when you last updated each file.
  18322.  
  18323.                       The separator used by TIME depends on the country code
  18324.                       defined in the CONFIG.SYS file or by the CHCP command.
  18325.  
  18326.  
  18327.  
  18328.  
  18329.  
  18330.  
  18331.  
  18332.  
  18333.  
  18334.  
  18335.  
  18336.  
  18337.  
  18338.  
  18339.           ___________________________________________________________________
  18340.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  314
  18341.  
  18342.                                 CHAPTER 8 / COMMAND REFERENCE GUIDE  /  TIMER
  18343.           ___________________________________________________________________
  18344.  
  18345.  
  18346.           TIMER                                                         (New)
  18347.  
  18348.           Purpose:    TIMER is a system stopwatch.
  18349.  
  18350.           Format:     TIMER [ON] [/1 /2 /3 /S]
  18351.  
  18352.                       ON:  Force the stopwatch to restart
  18353.  
  18354.                       /1 (stopwatch #1)           /3 (stopwatch #3)
  18355.                       /2 (stopwatch #2)           /S(plit)
  18356.  
  18357.           Usage:      The TIMER command turns a system stopwatch on and off.
  18358.                       When you first run TIMER, the stopwatch starts:
  18359.  
  18360.                            c:\> timer
  18361.                            Timer 1 on:  12:21:46
  18362.  
  18363.                       When you run TIMER again, the stopwatch stops and the
  18364.                       elapsed time is displayed:
  18365.  
  18366.                            c:\> timer
  18367.                            Timer 1 off:  12:21:58    Elapsed time:
  18368.                            0:00:12.06
  18369.  
  18370.                       There are three stopwatches available (1, 2, and 3) so
  18371.                       you can time multiple overlapping events.  By default,
  18372.                       TIMER uses stopwatch #1.
  18373.  
  18374.                       TIMER is particularly useful for timing events in batch
  18375.                       files.  For example, to time both an entire batch file,
  18376.                       and an intermediate section of the same file, you could
  18377.                       use commands like this:
  18378.  
  18379.                            rem Turn on timer 1
  18380.                            timer
  18381.                            rem Do some work here
  18382.                            rem Turn timer 2 on to time the next section
  18383.                            timer /2
  18384.                            rem Do some more work
  18385.                            echo Intermediate section completed
  18386.                            rem Display time taken in intermediate section
  18387.                            timer /2
  18388.                            rem Do some more work
  18389.                            rem Now display the total time
  18390.                            timer
  18391.  
  18392.  
  18393.  
  18394.  
  18395.  
  18396.           ___________________________________________________________________
  18397.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  315
  18398.  
  18399.                                 CHAPTER 8 / COMMAND REFERENCE GUIDE  /  TIMER
  18400.           ___________________________________________________________________
  18401.  
  18402.  
  18403.                       The smallest interval TIMER can measure is .06 second;
  18404.                       the largest interval is 23 hours, 59 minutes, 59.99
  18405.                       seconds.
  18406.  
  18407.           Options:    /1:  Use timer #1 (the default).
  18408.  
  18409.                       /2:  Use timer #2.
  18410.  
  18411.                       /3:  Use timer #3.
  18412.  
  18413.                       /S(plit):  Display a split time without stopping the
  18414.                       timer.  To display the current elapsed time but leave
  18415.                       the timer running:
  18416.  
  18417.                            c:\> timer /s
  18418.                            Timer 1 elapsed: 0:06:40.63
  18419.  
  18420.                       ON:   Start the timer regardless of its previous state
  18421.                       (on or off).  Otherwise the TIMER command toggles the
  18422.                       timer state (unless /S is used).
  18423.  
  18424.  
  18425.  
  18426.  
  18427.  
  18428.  
  18429.  
  18430.  
  18431.  
  18432.  
  18433.  
  18434.  
  18435.  
  18436.  
  18437.  
  18438.  
  18439.  
  18440.  
  18441.  
  18442.  
  18443.  
  18444.  
  18445.  
  18446.  
  18447.  
  18448.  
  18449.  
  18450.  
  18451.  
  18452.  
  18453.           ___________________________________________________________________
  18454.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  316
  18455.  
  18456.                              CHAPTER 8 / COMMAND REFERENCE GUIDE  /  TRUENAME
  18457.           ___________________________________________________________________
  18458.  
  18459.  
  18460.           TRUENAME                                                      (New)
  18461.  
  18462.           Purpose:    Find the full, true path and file name for a file.
  18463.  
  18464.           Format:     TRUENAME file
  18465.  
  18466.                       file:  The file whose name TRUENAME will report.
  18467.  
  18468.                       See also: @truename variable function on page 90.
  18469.  
  18470.           Usage:      Default directories, as well as the JOIN and SUBST
  18471.                       external commands, can obscure the true name of a file.
  18472.                       TRUENAME "sees through" these obstacles and reports the
  18473.                       fully qualified name of a file.
  18474.  
  18475.                       The following example uses TRUENAME to get the true
  18476.                       pathname for a file:
  18477.  
  18478.                            c:\> subst d: c:\util\test
  18479.                            c:\> truename d:\test.exe
  18480.                            c:\util\test\test.exe
  18481.  
  18482.                       TRUENAME requires MS-DOS or PC-DOS 3.0 or above.
  18483.  
  18484.  
  18485.  
  18486.  
  18487.  
  18488.  
  18489.  
  18490.  
  18491.  
  18492.  
  18493.  
  18494.  
  18495.  
  18496.  
  18497.  
  18498.  
  18499.  
  18500.  
  18501.  
  18502.  
  18503.  
  18504.  
  18505.  
  18506.  
  18507.  
  18508.  
  18509.  
  18510.           ___________________________________________________________________
  18511.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  317
  18512.  
  18513.                                  CHAPTER 8 / COMMAND REFERENCE GUIDE  /  TYPE
  18514.           ___________________________________________________________________
  18515.  
  18516.  
  18517.           TYPE                                                     (Enhanced)
  18518.  
  18519.           Purpose:    Display the contents of the specified file(s).
  18520.  
  18521.           Format:     TYPE [/L /P] file...
  18522.  
  18523.                       file:  The file or list of files that you want to
  18524.                       display.
  18525.  
  18526.                       /L(ine numbers)             /P(ause)
  18527.  
  18528.                       See also: LIST.
  18529.  
  18530.           Usage:      The TYPE command displays a file.  It is normally only
  18531.                       useful for displaying ASCII text files.  Executable
  18532.                       files (.COM and .EXE) and many data files may be
  18533.                       unreadable when displayed with TYPE because they
  18534.                       include non-alphanumeric characters.
  18535.  
  18536.                       To display the files MEMO1 and MEMO2:
  18537.  
  18538.                            c:\> type /p memo1 memo2
  18539.  
  18540.                       You can press Ctrl-S to pause TYPE's display and then
  18541.                       any key to continue.
  18542.  
  18543.                       You will probably find LIST to be more useful for
  18544.                       displaying files.  However, the TYPE /L command used
  18545.                       with redirection (see page 66) is useful if you want to
  18546.                       add line numbers to a file.
  18547.  
  18548.           Options:    /L(ine numbers):  Print a line number preceding each
  18549.                       line of text.
  18550.  
  18551.                       /P(ause):  Wait for a keystroke after displaying each
  18552.                       page.  Press Ctrl-C to quit, or any other key to
  18553.                       continue.
  18554.  
  18555.  
  18556.  
  18557.  
  18558.  
  18559.  
  18560.  
  18561.  
  18562.  
  18563.  
  18564.  
  18565.  
  18566.  
  18567.           ___________________________________________________________________
  18568.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  318
  18569.  
  18570.                               CHAPTER 8 / COMMAND REFERENCE GUIDE  /  UNALIAS
  18571.           ___________________________________________________________________
  18572.  
  18573.  
  18574.           UNALIAS                                                       (New)
  18575.  
  18576.           Purpose:    Remove aliases from the alias list.
  18577.  
  18578.           Format:     UNALIAS [/Q] alias...
  18579.                            or
  18580.                       UNALIAS *
  18581.  
  18582.                       alias:  One or more aliases to remove from memory.
  18583.  
  18584.                       /Q(uiet)
  18585.  
  18586.                       See also: ALIAS and ESET.
  18587.  
  18588.           Usage:      4DOS maintains a list of the aliases that you have
  18589.                       defined.  The UNALIAS command will remove aliases from
  18590.                       that list.  You can remove one or more aliases by name,
  18591.                       or you can delete the entire alias list by using the
  18592.                       command UNALIAS *
  18593.  
  18594.                       For example, to remove the alias DDIR:
  18595.  
  18596.                            c:\> unalias ddir
  18597.  
  18598.                       To remove all the aliases:
  18599.  
  18600.                            c:\> unalias *
  18601.  
  18602.           Options:    /Q(uiet):  Prevents UNALIAS from displaying an error
  18603.                       message if one or more of the aliases does not exist.
  18604.                       This option is most useful in batch files, for removing
  18605.                       a group of aliases when some of the aliases may not
  18606.                       have been defined.
  18607.  
  18608.  
  18609.  
  18610.  
  18611.  
  18612.  
  18613.  
  18614.  
  18615.  
  18616.  
  18617.  
  18618.  
  18619.  
  18620.  
  18621.  
  18622.  
  18623.  
  18624.           ___________________________________________________________________
  18625.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  319
  18626.  
  18627.                                 CHAPTER 8 / COMMAND REFERENCE GUIDE  /  UNSET
  18628.           ___________________________________________________________________
  18629.  
  18630.  
  18631.           UNSET                                                         (New)
  18632.  
  18633.           Purpose:    Remove variables from the environment.
  18634.  
  18635.           Format:     UNSET  [/M /Q] name...
  18636.                            or
  18637.                       UNSET *
  18638.  
  18639.                       name:  One or more variables to remove from the
  18640.                       environment.
  18641.  
  18642.                       /M(aster environment)       /Q(uiet)
  18643.  
  18644.                       See also: SET and ESET.
  18645.  
  18646.           Usage:      See the SET command and page 78 for a discussion of
  18647.                       environment variables.
  18648.  
  18649.                       UNSET removes one or more variables from the
  18650.                       environment.  For example, to remove the variable
  18651.                       CMDLINE:
  18652.  
  18653.                            c:\> unset cmdline
  18654.  
  18655.                       If you use the command UNSET *, all of the environment
  18656.                       variables will be deleted:
  18657.  
  18658.                            c:\> unset *
  18659.  
  18660.                       UNSET is often used in conjunction with the SETLOCAL
  18661.                       and ENDLOCAL commands in order to clear the environment
  18662.                       of variables that may cause problems for some
  18663.                       applications.
  18664.  
  18665.                   !   Use caution when removing environment variables, and
  18666.                       especially when using UNSET *.  Many programs will not
  18667.                       work properly without certain environment variables;
  18668.                       4DOS itself depends on PATH and COMSPEC.
  18669.  
  18670.           Options:##  /M(aster):  Remove the variable from the master
  18671.                       environment rather than the local environment.  This
  18672.                       option only makes sense if used in a secondary command
  18673.                       processor.
  18674.  
  18675.                       /Q(uiet):  Prevents UNSET from displaying an error
  18676.                       message if one or more of the variables does not exist.
  18677.                       This option is most useful in batch files, for removing
  18678.  
  18679.  
  18680.  
  18681.           ___________________________________________________________________
  18682.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  320
  18683.  
  18684.                                 CHAPTER 8 / COMMAND REFERENCE GUIDE  /  UNSET
  18685.           ___________________________________________________________________
  18686.  
  18687.  
  18688.                       a group of variables when some of the variables may not
  18689.                       have been defined.
  18690.  
  18691.  
  18692.  
  18693.  
  18694.  
  18695.  
  18696.  
  18697.  
  18698.  
  18699.  
  18700.  
  18701.  
  18702.  
  18703.  
  18704.  
  18705.  
  18706.  
  18707.  
  18708.  
  18709.  
  18710.  
  18711.  
  18712.  
  18713.  
  18714.  
  18715.  
  18716.  
  18717.  
  18718.  
  18719.  
  18720.  
  18721.  
  18722.  
  18723.  
  18724.  
  18725.  
  18726.  
  18727.  
  18728.  
  18729.  
  18730.  
  18731.  
  18732.  
  18733.  
  18734.  
  18735.  
  18736.  
  18737.  
  18738.           ___________________________________________________________________
  18739.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  321
  18740.  
  18741.                                   CHAPTER 8 / COMMAND REFERENCE GUIDE  /  VER
  18742.           ___________________________________________________________________
  18743.  
  18744.  
  18745.           VER                                                      (Enhanced)
  18746.  
  18747.           Purpose:    Display the current 4DOS and DOS versions.
  18748.  
  18749.           Format:     VER [/R]
  18750.  
  18751.                       /R(evision level)
  18752.  
  18753.           Usage:      Both the 4DOS and DOS version numbers consist of a one-
  18754.                       digit major version number, a period, and a one- or
  18755.                       two-digit minor version number.  The VER command
  18756.                       displays both version numbers:
  18757.  
  18758.                            c:\> ver
  18759.  
  18760.                            4DOS 4.02   DOS 5.0
  18761.  
  18762.                       VER will automatically detect OS/2 and DR-DOS and
  18763.                       display the corresponding operating system name and
  18764.                       version number.  For example:
  18765.  
  18766.                            c:\> ver
  18767.  
  18768.                            4DOS 4.02   OS/2 2.0
  18769.  
  18770.           Option:     /R(evision level):  Display the 4DOS and DOS, OS/2, or
  18771.                       DR-DOS revision level; and whether DOS is loaded into
  18772.                       the high memory area (HMA), is resident in ROM, or is
  18773.                       in normal base memory.  The output from /R related to
  18774.                       DOS is only meaningful in MS-DOS or PC-DOS version 5.0
  18775.                       or above.
  18776.  
  18777.  
  18778.  
  18779.  
  18780.  
  18781.  
  18782.  
  18783.  
  18784.  
  18785.  
  18786.  
  18787.  
  18788.  
  18789.  
  18790.  
  18791.  
  18792.  
  18793.  
  18794.  
  18795.           ___________________________________________________________________
  18796.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  322
  18797.  
  18798.                                CHAPTER 8 / COMMAND REFERENCE GUIDE  /  VERIFY
  18799.           ___________________________________________________________________
  18800.  
  18801.  
  18802.           VERIFY                                                 (Compatible)
  18803.  
  18804.           Purpose:    Enable or disable disk write verification or display
  18805.                       the verification state.
  18806.  
  18807.           Format:     VERIFY [ON | OFF]
  18808.  
  18809.           Usage:      DOS maintains an internal verify flag.  When the flag
  18810.                       is on, DOS attempts to verify each disk write by making
  18811.                       sure that the data written to the disk can be read back
  18812.                       successfully into the computer.  It does NOT compare
  18813.                       the data written with the data actually placed on disk.
  18814.  
  18815.                       If used without any parameters, VERIFY will display the
  18816.                       state of the DOS verify flag:
  18817.  
  18818.                            c:\> verify
  18819.                            VERIFY is OFF
  18820.  
  18821.                       VERIFY is off when the system boots up.  Once it is
  18822.                       turned on with the VERIFY ON command, it stays on until
  18823.                       you use the VERIFY OFF command or until you reboot.
  18824.  
  18825.                       Verification will slow your disk write operations
  18826.                       slightly.
  18827.  
  18828.  
  18829.  
  18830.  
  18831.  
  18832.  
  18833.  
  18834.  
  18835.  
  18836.  
  18837.  
  18838.  
  18839.  
  18840.  
  18841.  
  18842.  
  18843.  
  18844.  
  18845.  
  18846.  
  18847.  
  18848.  
  18849.  
  18850.  
  18851.  
  18852.           ___________________________________________________________________
  18853.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  323
  18854.  
  18855.                                   CHAPTER 8 / COMMAND REFERENCE GUIDE  /  VOL
  18856.           ___________________________________________________________________
  18857.  
  18858.  
  18859.           VOL                                                      (Enhanced)
  18860.  
  18861.           Purpose:    Display a disk volume label(s).
  18862.  
  18863.           Format:     VOL [d:] ...
  18864.  
  18865.                       d:  The drive or drives to search for labels.
  18866.  
  18867.           Usage:      Each disk may have a volume label, created when the
  18868.                       disk is formatted or with the DOS external LABEL
  18869.                       command.  Also, every floppy disk formatted with DOS
  18870.                       version 4.0 or above has a volume serial number.
  18871.  
  18872.                       The VOL command will display the volume label and, if
  18873.                       you are using DOS 4.0 or later, the volume serial
  18874.                       number of a disk volume.  If the disk doesn't have a
  18875.                       volume label, VOL will report that it is "unlabeled."
  18876.                       If you don't specify a drive, VOL displays information
  18877.                       about the current drive:
  18878.  
  18879.                            c:\> vol
  18880.                            Volume in drive C: is MYHARDDISK
  18881.  
  18882.                       If you are using DOS 4.0 or later, the disk serial
  18883.                       number will appear after the drive label or name.
  18884.  
  18885.                       To display the disk labels for drives A and B:
  18886.  
  18887.                            c:\> vol a: b:
  18888.                            Volume in drive A: is unlabeled
  18889.                            Volume in drive B: is BACKUP_2
  18890.  
  18891.  
  18892.  
  18893.  
  18894.  
  18895.  
  18896.  
  18897.  
  18898.  
  18899.  
  18900.  
  18901.  
  18902.  
  18903.  
  18904.  
  18905.  
  18906.  
  18907.  
  18908.  
  18909.           ___________________________________________________________________
  18910.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  324
  18911.  
  18912.                               CHAPTER 8 / COMMAND REFERENCE GUIDE  /  VSCRPUT
  18913.           ___________________________________________________________________
  18914.  
  18915.  
  18916.           VSCRPUT                                                       (New)
  18917.  
  18918.           Purpose:    Display text vertically in the specified color.
  18919.  
  18920.           Format:     VSCRPUT  row col [BRIght] [BLInk] fg ON [BRIght] bg
  18921.                            text
  18922.  
  18923.                       row:  Starting row number.
  18924.                       col:  Starting column number
  18925.                       fg:  Foreground text color
  18926.                       bg:  Background text color
  18927.                       text:  The text to display
  18928.  
  18929.                       The available colors are:
  18930.  
  18931.                         Black         Blue          Green         Red
  18932.                         Magenta       Cyan          Yellow        White
  18933.  
  18934.                       See also: SCRPUT.
  18935.  
  18936.           Usage:      VSCRPUT writes text vertically on the screen rather
  18937.                       than horizontally.  Like the SCRPUT command, it uses
  18938.                       the colors you specify to write the text.  VSCRPUT can
  18939.                       be used for simple graphs and charts generated by batch
  18940.                       files.
  18941.  
  18942.                       The row and column are zero-based, so on a standard 25
  18943.                       row by 80 column display, valid rows are 0 - 24 and
  18944.                       valid columns are 0 - 79.
  18945.  
  18946.                       Only the first three characters of the color name and
  18947.                       the attributes BRIGHT and BLINK are required.  Bright
  18948.                       backgrounds will not work unless BrightBG is set to Yes
  18949.                       in 4DOS.INI (see page 129).
  18950.  
  18951.                       The following batch file fragment displays an X and Y
  18952.                       axis and labels them:
  18953.  
  18954.                            cls bright white on blue
  18955.                            drawhline 20 10 40 1 bright white on blue
  18956.                            drawvline 2 10 19 1 bright white on blue
  18957.                            scrput 21 20 bright red on blue X axis
  18958.                            vscrput 8 9 bright red on blue Y axis
  18959.  
  18960.                       VSCRPUT checks for a valid row and column, and displays
  18961.                       a "Usage" error message if either value is out of
  18962.                       range.
  18963.  
  18964.  
  18965.  
  18966.           ___________________________________________________________________
  18967.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  325
  18968.  
  18969.                                     CHAPTER 8 / COMMAND REFERENCE GUIDE  /  Y
  18970.           ___________________________________________________________________
  18971.  
  18972.  
  18973.           Y                                                             (New)
  18974.  
  18975.           Purpose:    Copy standard input to standard output, and then copy
  18976.                       the specified file(s) to standard output.
  18977.  
  18978.           Format:     Y file ...
  18979.  
  18980.                       file:  The file or list of files to send to standard
  18981.                       output.
  18982.  
  18983.                       See also: TEE.
  18984.  
  18985.           ## Usage:   The Y command copies input from standard input (usually
  18986.                       the keyboard) to standard output (usually the screen).
  18987.                       Once the input ends, the named files are appended to
  18988.                       standard output.
  18989.  
  18990.                       For example, to get text from standard input, append
  18991.                       the files MEMO1 and MEMO2 to it, and send the output to
  18992.                       MEMOS:
  18993.  
  18994.                            c:\> y memo1 memo2 > memos
  18995.  
  18996.                       The Y command is most useful if you want to add
  18997.                       redirected data to the beginning of a file instead of
  18998.                       appending it to the end.
  18999.  
  19000.                       If you are typing at the keyboard to produce input text
  19001.                       for Y, you must enter a Ctrl-Z to terminate the input.
  19002.  
  19003.  
  19004.  
  19005.  
  19006.  
  19007.  
  19008.  
  19009.  
  19010.  
  19011.  
  19012.  
  19013.  
  19014.  
  19015.  
  19016.  
  19017.  
  19018.  
  19019.  
  19020.  
  19021.  
  19022.  
  19023.           ___________________________________________________________________
  19024.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  326
  19025.  
  19026.                                              APPENDIX A / 4DOS ERROR MESSAGES
  19027.           ___________________________________________________________________
  19028.  
  19029.  
  19030.  
  19031.           APPENDIX A / 4DOS ERROR MESSAGES
  19032.  
  19033.  
  19034.           This appendix lists error messages generated by 4DOS, and includes
  19035.           a recommended course of action for most errors.  If you are unable
  19036.           to resolve the problem look through Chapter 7 / Using 4DOS With
  19037.           Your Hardware and Software, beginning on page 143, or contact JP
  19038.           Software for technical support (see page 7).
  19039.  
  19040.           Error messages relating to files are generally reports of errors
  19041.           returned by DOS.  You may find some of these messages (for example,
  19042.           "Access denied") vague enough that they are not always helpful.
  19043.           4DOS includes the file name in file error messages, but is often
  19044.           unable to determine a more accurate explanation of these DOS
  19045.           errors.  The message shown is the best information available based
  19046.           on the error codes returned by DOS.
  19047.  
  19048.           The following list includes all error messages, in alphabetical
  19049.           order:
  19050.  
  19051.               4DOS initialization error --:  An error occurred during the
  19052.               4DOS startup process.  Look up the rest of the message in this
  19053.               list for a more specific explanation.
  19054.  
  19055.               4DOS internal stack overflow:  You attempted to nest batch
  19056.               files or commands like EXCEPT, FOR, IF, IFF, GLOBAL, or SELECT
  19057.               too deep, and 4DOS ran out of stack space.  Restructure your
  19058.               command, alias, or batch file, or use the StackSize directive
  19059.               in 4DOS.INI to increase 4DOS's internal stack size.
  19060.  
  19061.               4DOS server error --:  An error occurred in communication
  19062.               between 4DOS's resident and transient portions.  Look up the
  19063.               rest of the message in this list for a more specific
  19064.               explanation.
  19065.  
  19066.               4DOS swapping failed, loading in non-swapping mode:  None of
  19067.               the swapping options worked, so 4DOS loaded in non-swapping
  19068.               mode, which requires about 92K more memory than swapping mode.
  19069.               Check your Swapping specification in 4DOS.INI, and/or free
  19070.               some XMS or EMS memory or disk space.
  19071.  
  19072.               4DOS unrecoverable error XX:  An error occurred in the
  19073.               resident portion of 4DOS.  These errors will terminate
  19074.               secondary shells and require a reboot if they occur during a
  19075.               primary shell or if 4DOS cannot continue.
  19076.  
  19077.                    BI    Bad server function code.  Contact JP Software.
  19078.  
  19079.  
  19080.           ___________________________________________________________________
  19081.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  327
  19082.  
  19083.                                              APPENDIX A / 4DOS ERROR MESSAGES
  19084.           ___________________________________________________________________
  19085.  
  19086.  
  19087.                    DI    Same as Disk swap file corrupted.
  19088.                    DR    Same as Swap file read error.
  19089.                    DS    Same as Swap file seek error.
  19090.                    EI    Same as EMS mapping error.
  19091.                    NS    No number for new shell.  You have started too many
  19092.                          4DOS secondary shells without properly exiting some
  19093.                          of them, perhaps by closing DESQview windows rather
  19094.                          than EXITing.  Clean up any work in process and
  19095.                          reboot the system.
  19096.                    PT    Illegal process termination.  Contact JP Software.
  19097.                    TS    Terminated inactive shell.  Contact JP Software.
  19098.                    XI    Same as XMS move failed.
  19099.  
  19100.               Access denied:  You tried to write to or erase a read-only
  19101.               protected file, to rename a file or directory to an existing
  19102.               name, to create a directory that already exists, or to remove
  19103.               a read-only directory or a directory with files or
  19104.               subdirectories still in it.
  19105.  
  19106.               Alias loop:  An alias refers back to itself either directly or
  19107.               indirectly (i.e., a = b = a), or aliases are nested more than
  19108.               16 deep.  Correct your alias list.
  19109.  
  19110.               Ambiguous directive name:  The name of a 4DOS.INI directive
  19111.               was not fully spelled out and was therefore ambiguous.  Spell
  19112.               out the directive more fully to make its name unambiguous.
  19113.  
  19114.               Attempt to exit from root shell:  Another program has
  19115.               destroyed a portion of 4DOS's memory.  Reboot the system; if
  19116.               the error persists, contact JP Software.
  19117.  
  19118.               Bad disk unit:  Generally caused by a disk drive hardware
  19119.               failure.
  19120.  
  19121.               Bad environment:  The DOS environment has a bad structure,
  19122.               probably because a program destroyed 4DOS's master environment
  19123.               space.  Reboot the system.
  19124.  
  19125.               Batch file missing:  4DOS can't find the batch (.BAT) file it
  19126.               was running.  It was either deleted, renamed, moved, or the
  19127.               disk was changed.  Correct the problem and rerun the file.
  19128.  
  19129.               Can't copy file to itself:  4DOS will not permit you to COPY
  19130.               or MOVE a file to itself.  4DOS performs full path and
  19131.               filename expansion before copying to ensure that files aren't
  19132.               inadvertently destroyed.
  19133.  
  19134.  
  19135.  
  19136.  
  19137.           ___________________________________________________________________
  19138.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  328
  19139.  
  19140.                                              APPENDIX A / 4DOS ERROR MESSAGES
  19141.           ___________________________________________________________________
  19142.  
  19143.  
  19144.               Can't create:  4DOS can't create the specified file.  The disk
  19145.               may be full or write protected, or the file already exists and
  19146.               is read-only, or the root directory is full.
  19147.  
  19148.               Can't delete:  4DOS can't delete the specified file or
  19149.               directory.  The disk is probably write protected.
  19150.  
  19151.               Can't get directory:  4DOS can't read the directory.  The disk
  19152.               drive is probably not ready.
  19153.  
  19154.               Can't make directory entry:  4DOS can't create the filename in
  19155.               the directory.  This is usually caused by a full root
  19156.               directory.  Create a subdirectory and move some of the files
  19157.               to it.
  19158.  
  19159.               Can't open:  4DOS can't open the specified file.  Either the
  19160.               file doesn't exist or the disk directory or File Allocation
  19161.               Table is damaged.
  19162.  
  19163.               Can't remove current directory:  You attempted to remove the
  19164.               current directory, which DOS does not allow.  Change to the
  19165.               parent directory and try again.
  19166.  
  19167.               Can't set up disk swap file:  The disk swap file you specified
  19168.               cannot be opened.  The path or drive is invalid, the disk is
  19169.               full, DOS is out of file handles, or there is a hardware
  19170.               problem.  Check 4DOS.INI to be sure your Swapping directive is
  19171.               correct.
  19172.  
  19173.               Command line too long:  A single command exceeded 255
  19174.               characters, or the entire command line exceeded 511
  19175.               characters, during alias and variable expansion.  To address
  19176.               this reduce the complexity of the command, or use a batch
  19177.               file.  This error also occurs if you pass an extremely long
  19178.               command line to 4DOS on your SHELL= line in CONFIG.SYS and
  19179.               4DOS does not have room for your command line and the
  19180.               necessary directory information for the COMSPEC environment
  19181.               variable.  In this case, place the commands in a batch file
  19182.               and invoke the batch file from your SHELL= line.
  19183.  
  19184.               Command tail too long:  A program attempted to pass a command
  19185.               in an improper format or a command longer than 126 characters
  19186.               to 4DOS.  This is probably a bug in the program from which
  19187.               4DOS was loaded.  Contact the author of the program or JP
  19188.               Software for technical assistance.
  19189.  
  19190.               Contents lost before copy:  COPY was appending files, and
  19191.               found one of the source files is the same as the target.  That
  19192.  
  19193.  
  19194.           ___________________________________________________________________
  19195.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  329
  19196.  
  19197.                                              APPENDIX A / 4DOS ERROR MESSAGES
  19198.           ___________________________________________________________________
  19199.  
  19200.  
  19201.               source file is skipped, and appending continues with the next
  19202.               file.
  19203.  
  19204.               Data error:  DOS can't read or write properly to the device.
  19205.               On a floppy drive, this error is usually caused by a defective
  19206.               floppy disk, dirty disk drive heads, or a misalignment between
  19207.               the heads on your drive and the drive on which the disk was
  19208.               created.  On a hard drive, this error may indicate a drive
  19209.               that is too hot or too cold, or a hardware problem.  Retry the
  19210.               operation; if it fails again, correct the hardware or diskette
  19211.               problem.
  19212.  
  19213.               Directory stack empty:  POPD or DIRS can't find any entries in
  19214.               the directory stack.
  19215.  
  19216.               Disk is write protected:  The disk cannot be written to.
  19217.               Check the disk and remove the write-protect tab or close the
  19218.               write-protect window if necessary.
  19219.  
  19220.               Disk swap file corrupted:  The 4DOS disk swapping file
  19221.               (4DOSSWAP.nnn) has been moved, deleted, or damaged by another
  19222.               program.  Reboot the system.
  19223.  
  19224.               Drive not ready--close door:  The floppy disk drive door is
  19225.               open.  Close the door and try again.
  19226.  
  19227.               EMS deallocation failed:  4DOS can't deallocate EMS memory
  19228.               when exiting from a secondary shell.  The EMS map has been
  19229.               corrupted or the memory area used by 4DOS or the EMS driver
  19230.               has been destroyed by a program.  Clean up any work in process
  19231.               and reboot the system.
  19232.  
  19233.               EMS map save or restore failed:  4DOS cannot save or restore
  19234.               the EMS page map.  The EMS map has been corrupted, memory has
  19235.               been destroyed by a program, or you have an incompatible EMS
  19236.               driver.  If this error recurs, try another swapping method,
  19237.               update your EMS driver, or contact JP Software.
  19238.  
  19239.               EMS mapping failed:  4DOS can't map EMS pages when swapping to
  19240.               or from EMS.  The EMS map has been corrupted or the memory
  19241.               area used by the loader or the EMS driver has been destroyed
  19242.               by a program.  Reboot the system.
  19243.  
  19244.               Environment already saved:  You have already saved the
  19245.               environment with a previous SETLOCAL command.  You cannot nest
  19246.               SETLOCAL / ENDLOCAL pairs.
  19247.  
  19248.  
  19249.  
  19250.  
  19251.           ___________________________________________________________________
  19252.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  330
  19253.  
  19254.                                              APPENDIX A / 4DOS ERROR MESSAGES
  19255.           ___________________________________________________________________
  19256.  
  19257.  
  19258.               Error in command line directive:  You used the //iniline
  19259.               option to place a 4DOS.INI directive on the SHELL= line in
  19260.               CONFIG.SYS or on the startup command line for a secondary
  19261.               shell, but the directive is in error.  A more specific error
  19262.               message follows.
  19263.  
  19264.               Error on line [nnnn] of [filename]:  There is an error in your
  19265.               4DOS.INI file.  The following message explains the error in
  19266.               more detail.  Correct the line in error, and restart 4DOS for
  19267.               your change to take effect.
  19268.  
  19269.               Error reading:  DOS experienced an I/O error when reading from
  19270.               a device.  This is usually caused by a bad disk, a device not
  19271.               ready, or a hardware error.
  19272.  
  19273.               Error writing:  DOS experienced an I/O error when writing to a
  19274.               device.  This is usually caused by a full disk, a bad disk, a
  19275.               device not ready, or a hardware error.
  19276.  
  19277.               Exceeded batch nesting limit:  You have attempted to nest
  19278.               batch files more than 10 levels deep.
  19279.  
  19280.               Fatal error -- please reboot:  4DOS cannot continue due to the
  19281.               previous error.  Reboot the system.
  19282.  
  19283.               File Allocation Table bad:  DOS can't access the FAT on the
  19284.               specified disk.  This can be caused by a bad disk, a hardware
  19285.               error, or an unusual software interaction.
  19286.  
  19287.               File exists:  The requested output file already exists, and
  19288.               4DOS won't overwrite it.
  19289.  
  19290.               File not found:  4DOS couldn't find the specified file.  Check
  19291.               the spelling or path name.
  19292.  
  19293.               General failure:  This is usually a hardware problem,
  19294.               particularly a disk drive failure or a device not properly
  19295.               connected to a serial or parallel port.  Try to correct the
  19296.               problem or reboot and try again.
  19297.  
  19298.               I/O error in [filename] ... some directives may not have been
  19299.               processed:  AN I/O error occurred while reading your 4DOS.INI
  19300.               file.  There may be a physical problem with data on the disk,
  19301.               or a sharing error on a multitasking system.  Check your
  19302.               4DOS.INI file and try again.
  19303.  
  19304.               Illegal Swapping option or path:  The swap type or disk swap
  19305.               path in the 4DOS.INI Swapping directive is invalid.  4DOS
  19306.  
  19307.  
  19308.           ___________________________________________________________________
  19309.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  331
  19310.  
  19311.                                              APPENDIX A / 4DOS ERROR MESSAGES
  19312.           ___________________________________________________________________
  19313.  
  19314.  
  19315.               ignores the bad swap type or path and attempts to scan the
  19316.               rest of the Swapping specification for a valid option.
  19317.               Multiple errors in the Swapping directive will cause this
  19318.               message to repeat.  Correct 4DOS.INI and reboot the system for
  19319.               the corrected swap type to take effect.
  19320.  
  19321.               INI file processing error at line n, remainder of file
  19322.               skipped:  An input error (such as a data error) has prevented
  19323.               4DOS from fully processing your 4DOS.INI file.  Check that the
  19324.               file is readable by another program, or TYPE it to ensure that
  19325.               4DOS reads the file properly.
  19326.  
  19327.               Insufficient disk space:  COPY or MOVE ran out of room on the
  19328.               destination drive.  Remove some files and retry the operation.
  19329.  
  19330.               Insufficient load space:  There is not enough room in 4DOS's
  19331.               internal memory areas to include all of the options you
  19332.               requested in 4DOS.INI.  Contact JP Software for assistance.
  19333.  
  19334.               Internal DOS error:  DOS encountered an internal bug and
  19335.               failed. Reboot the system.
  19336.  
  19337.               Invalid choice value:  You gave an invalid value for a
  19338.               "choice" directive (one that accepts a choice from a list,
  19339.               like "Yes" or "No") in 4DOS.INI.
  19340.  
  19341.               Invalid color:  You gave an invalid value for a color
  19342.               directive in 4DOS.INI.
  19343.  
  19344.               Invalid date:  An invalid date was entered.  Check the syntax
  19345.               and reenter.
  19346.  
  19347.               Invalid drive:  A bad or non-existent disk drive was
  19348.               specified.
  19349.  
  19350.               Invalid DOS version:  You need a newer version of DOS to
  19351.               execute the specified command.
  19352.  
  19353.               Invalid directive name:  4DOS can't recognize the name of a
  19354.               directive in your 4DOS.INI file.
  19355.  
  19356.               Invalid key name:  You tried to make an invalid key
  19357.               substitution in 4DOS.INI, or you used an invalid key name in a
  19358.               keystroke alias or KEYSTACK.  Correct the error and retry the
  19359.               operation.
  19360.  
  19361.               Invalid numeric value:  You gave an invalid value for a
  19362.               numeric directive in 4DOS.INI.
  19363.  
  19364.  
  19365.           ___________________________________________________________________
  19366.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  332
  19367.  
  19368.                                              APPENDIX A / 4DOS ERROR MESSAGES
  19369.           ___________________________________________________________________
  19370.  
  19371.  
  19372.               Invalid parameter:  4DOS didn't recognize a parameter.  Check
  19373.               the syntax and spelling.
  19374.  
  19375.               Invalid path:  The specified path does not exist.  Check the
  19376.               disk specification and/or spelling.
  19377.  
  19378.               Invalid path specification:  You used an invalid path in a
  19379.               path or filename directive in 4DOS.INI.
  19380.  
  19381.               Invalid section name:  You used an invalid section name in
  19382.               4DOS.INI.  The only valid section names are [Primary] and
  19383.               [Secondary].
  19384.  
  19385.               Invalid startup switch, ignored:  You passed 4DOS an invalid
  19386.               option on the SHELL= line in CONFIG.SYS or on the startup
  19387.               command line for a secondary shell.  Correct the switch.
  19388.  
  19389.               Invalid time:  An invalid time was entered.  Check the syntax
  19390.               and reenter.
  19391.  
  19392.               Keystroke substitution table full:  4DOS ran out of room to
  19393.               store keystroke substitutions entered in 4DOS.INI.  Reduce the
  19394.               number of key substitutions or contact JP Software for
  19395.               assistance.
  19396.  
  19397.               KSTACK.COM not loaded:  You attempted to execute a KEYSTACK
  19398.               command without loading KSTACK.COM.  See the KEYSTACK command
  19399.               for more information.
  19400.  
  19401.               Label not found:  A GOTO or GOSUB referred to a non-existent
  19402.               label. Check your batch file.
  19403.  
  19404.               Memory allocation error:  4DOS can't allocate memory while
  19405.               loading or while reserving memory for internal use.  DOS
  19406.               memory allocation has been corrupted.  Reboot the system.
  19407.  
  19408.               Memory deallocation error:  Similar to memory allocation
  19409.               error; memory has been corrupted.  Reboot the system.
  19410.  
  19411.               Memory destroyed:  The DOS memory control blocks have been
  19412.               corrupted.  Reboot the system.
  19413.  
  19414.               Missing ENDTEXT:  A TEXT command is missing a matching
  19415.               ENDTEXT.  Check the batch file.
  19416.  
  19417.               Missing GOSUB:  4DOS cannot perform the RETURN command in a
  19418.               batch file.  You tried to do a RETURN without a GOSUB, or your
  19419.               batch file has been corrupted.
  19420.  
  19421.  
  19422.           ___________________________________________________________________
  19423.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  333
  19424.  
  19425.                                              APPENDIX A / 4DOS ERROR MESSAGES
  19426.           ___________________________________________________________________
  19427.  
  19428.  
  19429.               Missing SETLOCAL:  4DOS encountered an ENDLOCAL without a
  19430.               matching SETLOCAL.
  19431.  
  19432.               No aliases defined:  You tried to display aliases but no
  19433.               aliases have been defined.
  19434.  
  19435.               No closing quote:  4DOS couldn't find a second matching quote
  19436.               (` or ") on the command line.
  19437.  
  19438.               No expression:  The expression passed to the %@EVAL variable
  19439.               function is empty.  Correct the expression and retry the
  19440.               operation.
  19441.  
  19442.               No file handle available:  This is an internal 4DOS disk
  19443.               swapping error.  Change to another swapping method if
  19444.               possible, and contact JP Software.
  19445.  
  19446.               No room for INI file name.   4DOS does not have enough space
  19447.               in the INI file string area to pass the name of your 4DOS.INI
  19448.               file to secondary shells.  4DOS will load and run properly,
  19449.               but any [Secondary] section in 4DOS.INI will be ignored in
  19450.               secondary shells.  Reduce the complexity of 4DOS.INI or
  19451.               contact JP Software for assistance.
  19452.  
  19453.               No UMBs; loading low:  The LOADHIGH (or LH) command can't find
  19454.               any UMBs for your program.  The program is loaded into base
  19455.               memory.  LH and LOADHIGH only work with MS-DOS 5.0 and above,
  19456.               when the DOS=UMB directive is included in CONFIG.SYS and
  19457.               sufficient upper memory space is available for the program.
  19458.  
  19459.               No upper memory available, master environment will be placed
  19460.               in low memory:  You asked 4DOS to load the master environment
  19461.               into an UMB via the UMBEnvironment directive in 4DOS.INI, but
  19462.               no UMB was available.  Check that your XMS driver is properly
  19463.               installed and / or free up some UMB space in use by another
  19464.               program.
  19465.  
  19466.               No upper memory available, resident portion will remain in low
  19467.               memory:  You requested relocation of the 4DOS resident portion
  19468.               to an UMB via the UMBLoad directive in 4DOS.INI, but no UMB
  19469.               was available.  Check that your XMS driver is properly
  19470.               installed and / or free up some UMB space in use by another
  19471.               program.
  19472.  
  19473.               Non-DOS disk:  DOS can't read the disk.  Either the disk is
  19474.               bad, or it has been formatted by a different operating system.
  19475.               Reformat it as a DOS disk.
  19476.  
  19477.  
  19478.  
  19479.           ___________________________________________________________________
  19480.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  334
  19481.  
  19482.                                              APPENDIX A / 4DOS ERROR MESSAGES
  19483.           ___________________________________________________________________
  19484.  
  19485.  
  19486.               Not an alias:  The specified alias is not in the 4DOS alias
  19487.               list.
  19488.  
  19489.               Not in environment:  The specified variable is not in the
  19490.               environment.
  19491.  
  19492.               Not in swapping mode:  You attempted to turn swapping on or
  19493.               off with the SWAPPING command, but 4DOS is loaded in memory-
  19494.               resident mode and swapping is not active.
  19495.  
  19496.               Not ready:  The specified device can't be accessed.
  19497.  
  19498.               Not same device:  This error usually appears in RENAME.  You
  19499.               cannot rename a file to a different disk drive.
  19500.  
  19501.               Out of environment / alias space:  4DOS has run out of space
  19502.               for environment variables or aliases.  Edit the SHELL line in
  19503.               CONFIG.SYS or the Environment directive in 4DOS.INI to
  19504.               increase the environment size, or the Alias directive in
  19505.               4DOS.INI to increase the alias list size.
  19506.  
  19507.               Out of memory:  DOS or 4DOS had insufficient free memory to
  19508.               execute the last command, or the DOS memory control blocks
  19509.               have been destroyed.  If this error occurs in a secondary
  19510.               shell, return to the primary shell before running the command.
  19511.               Otherwise, try to free some memory by removing memory-resident
  19512.               programs.  If the error persists, use the MEMORY command to
  19513.               determine the actual memory available.  If the base memory
  19514.               (DOS RAM) figures reported by MEMORY are unreasonable, the
  19515.               memory control blocks have probably been destroyed and you
  19516.               must reboot the system.  If you receive this error from DIR
  19517.               when the MEMORY command shows sufficient memory for the
  19518.               directory you are displaying, memory has probably been
  19519.               "fragmented", and contains a free area larger than 8K but not
  19520.               large enough for the entire directory.  Use a memory mapping
  19521.               program like PMAP, MAPMEM, or MANIFEST to determine where the
  19522.               fragmentation is, and experiment with your TSRs and
  19523.               applications to determine and remove its cause.
  19524.  
  19525.               Out of paper:  DOS detected an out-of-paper condition on one
  19526.               of the parallel printers (LPT1, LPT2, or LPT3).  Check your
  19527.               printer and add paper if necessary.
  19528.  
  19529.               Overflow:  An arithmetic overflow occurred in the %@EVAL
  19530.               variable function.  Check the values being passed to %@EVAL.
  19531.               %@EVAL can handle 16 digits to the left of the decimal point
  19532.               and 8 to the right.
  19533.  
  19534.  
  19535.  
  19536.           ___________________________________________________________________
  19537.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  335
  19538.  
  19539.                                              APPENDIX A / 4DOS ERROR MESSAGES
  19540.           ___________________________________________________________________
  19541.  
  19542.  
  19543.               Read error:  DOS disk read error; usually caused by a bad disk
  19544.               or a non-DOS disk.
  19545.  
  19546.               Sector not found:  BIOS disk error; usually caused by a bad
  19547.               disk or a non-DOS disk.
  19548.  
  19549.               Seek error:  DOS can't seek to the proper location on the
  19550.               disk.  This is generally caused by a bad disk or drive.
  19551.  
  19552.               String area overflow:  4DOS ran out of room to store the text
  19553.               from string directives in 4DOS.INI.  Reduce the complexity of
  19554.               4DOS.INI or contact JP Software for assistance.
  19555.  
  19556.               Swap file [seek | read | write] failed:  4DOS  encountered an
  19557.               I/O error while accessing the disk swap file (4DOSSWAP.nnn).
  19558.               The disk was changed, the file has been destroyed by a
  19559.               program, or 4DOS's memory area has been overwritten by a
  19560.               program.  Reboot the system.
  19561.  
  19562.               Syntax error:  A command or variable function was entered in
  19563.               an improper format.  Check the syntax in this manual and
  19564.               correct the error.
  19565.  
  19566.               Too many DR-DOS SETs in CONFIG.SYS:  The SET commands in your
  19567.               DR-DOS CONFIG.SYS file exceeded the size of 4DOS's buffer
  19568.               area.  Reduce the number or length of the commands or contact
  19569.               JP Software for assistance.
  19570.  
  19571.               Too many open files:  DOS has run out of file handles.  Try
  19572.               setting FILES=20 or more in your CONFIG.SYS file.
  19573.  
  19574.               Transient memory allocation error:  4DOS couldn't reserve
  19575.               memory for its transient portion (probably in a SWAPPING OFF
  19576.               command).  The memory control blocks have been destroyed, or a
  19577.               program has fragmented memory.  Reboot the system.
  19578.  
  19579.               Transient memory deallocation error:  4DOS couldn't release
  19580.               memory for its transient portion (probably in a SWAPPING ON
  19581.               command).  The memory control blocks have been destroyed, or a
  19582.               program has fragmented memory.  Reboot the system.
  19583.  
  19584.               Unbalanced parentheses:  The number of left and right
  19585.               parentheses did not match in an expression passed to the
  19586.               %@EVAL variable function.  Correct the expression and retry
  19587.               the operation.
  19588.  
  19589.  
  19590.  
  19591.  
  19592.  
  19593.           ___________________________________________________________________
  19594.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  336
  19595.  
  19596.                                              APPENDIX A / 4DOS ERROR MESSAGES
  19597.           ___________________________________________________________________
  19598.  
  19599.  
  19600.               Unknown command:  A command was entered that 4DOS didn't
  19601.               recognize and couldn't find in the current search path.  Check
  19602.               the spelling or PATH specification.
  19603.  
  19604.               Variable loop:  A nested environment variable refers to
  19605.               itself, or variables are nested more than 16 deep.  Correct
  19606.               the error and retry the command.
  19607.  
  19608.               Write error:  A DOS disk error, usually caused by a bad disk
  19609.               or a non-DOS disk.
  19610.  
  19611.               XMS deallocation failed:  4DOS could not deallocate XMS memory
  19612.               when exiting a secondary shell.  XMS memory has been
  19613.               destroyed; reboot your system.
  19614.  
  19615.               XMS move failed:  4DOS could not move data between base memory
  19616.               and XMS memory while swapping itself.  XMS memory has been
  19617.               destroyed; reboot your system.
  19618.  
  19619.  
  19620.  
  19621.  
  19622.  
  19623.  
  19624.  
  19625.  
  19626.  
  19627.  
  19628.  
  19629.  
  19630.  
  19631.  
  19632.  
  19633.  
  19634.  
  19635.  
  19636.  
  19637.  
  19638.  
  19639.  
  19640.  
  19641.  
  19642.  
  19643.  
  19644.  
  19645.  
  19646.  
  19647.  
  19648.  
  19649.  
  19650.           ___________________________________________________________________
  19651.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  337
  19652.  
  19653.                                              APPENDIX B / ASCII AND KEY CODES
  19654.           ___________________________________________________________________
  19655.  
  19656.  
  19657.  
  19658.           APPENDIX B / ASCII AND KEY CODES
  19659.  
  19660.  
  19661.           ASCII
  19662.  
  19663.               To represent the text you type, computers must translate each
  19664.               letter to and from a number.  The code used by all PC-
  19665.               compatible computers for this translation is called ASCII
  19666.               (American Standard Code for Information Interchange).  ASCII
  19667.               codes are also used for the characters displayed on the
  19668.               screen.  Function keys, cursor keys, and Alt keys do not
  19669.               generate ASCII codes.  For details on these keys and a
  19670.               reference table, see Keys and Key Codes later in this
  19671.               Appendix.
  19672.  
  19673.               The ASCII table on the following pages is in three parts.  The
  19674.               first two parts cover the 128 standard ASCII characters; the
  19675.               third part covers the additional 128 extended ASCII characters
  19676.               defined by IBM for use on the IBM PC and compatible computers.
  19677.               All the tables include a Char column showing the visual
  19678.               representation of the character, a Dec column showing the
  19679.               decimal numeric value of the character in the ASCII set, and a
  19680.               Hex column showing the hexadecimal (base-16) value.  The
  19681.               tables are divided as follows:
  19682.  
  19683.               ASCII Control Characters have numeric values between 0 and 31,
  19684.               and include non-printing characters like carriage return and
  19685.               line feed.  The ASCII standard does not define a visual
  19686.               representation for control characters, but the IBM PC
  19687.               character set does define one for most control characters as
  19688.               shown in the Char column of the table.  You can enter these
  19689.               characters using the Ctrl key combination shown in the Ctrl
  19690.               column of this table, with a caret [^] representing the Ctrl
  19691.               key.  For example, character 4 is shown as ^D;  to enter it,
  19692.               press Ctrl and D on your keyboard.  You can also enter control
  19693.               characters with the Alt key and the numeric keypad, like
  19694.               extended ASCII codes (see below).  The Name column of this
  19695.               table shows a two or three character "name" given to each
  19696.               control character as part of the ASCII standard.
  19697.  
  19698.               ASCII Printing Characters have numeric values between 32 and
  19699.               127, and include the entire English-language character set as
  19700.               well as punctuation and other special marks.  You enter these
  19701.               characters by pressing the corresponding keyboard key.
  19702.               Character 127 has no corresponding keyboard key, but can be
  19703.               entered on many systems by typing Ctrl-Backspace.
  19704.  
  19705.  
  19706.  
  19707.           ___________________________________________________________________
  19708.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  338
  19709.  
  19710.                                              APPENDIX B / ASCII AND KEY CODES
  19711.           ___________________________________________________________________
  19712.  
  19713.  
  19714.               Extended ASCII Characters have values between 128 and 255 and
  19715.               include international language characters, line-drawing
  19716.               characters, and other graphics symbols.  You can enter
  19717.               extended ASCII codes on the keyboard by holding down the Alt
  19718.               key, entering the decimal numeric value of the key on the
  19719.               numeric keypad, and then releasing the Alt key.
  19720.  
  19721.  
  19722.  
  19723.  
  19724.  
  19725.  
  19726.  
  19727.  
  19728.  
  19729.  
  19730.  
  19731.  
  19732.  
  19733.  
  19734.  
  19735.  
  19736.  
  19737.  
  19738.  
  19739.  
  19740.  
  19741.  
  19742.  
  19743.  
  19744.  
  19745.  
  19746.  
  19747.  
  19748.  
  19749.  
  19750.  
  19751.  
  19752.  
  19753.  
  19754.  
  19755.  
  19756.  
  19757.  
  19758.  
  19759.  
  19760.  
  19761.  
  19762.  
  19763.  
  19764.           ___________________________________________________________________
  19765.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  339
  19766.  
  19767.                                              APPENDIX B / ASCII AND KEY CODES
  19768.           ___________________________________________________________________
  19769.  
  19770.  
  19771.  
  19772.  
  19773.  
  19774.  
  19775.  
  19776.  
  19777.  
  19778.  
  19779.  
  19780.  
  19781.  
  19782.  
  19783.  
  19784.  
  19785.  
  19786.  
  19787.  
  19788.  
  19789.  
  19790.  
  19791.  
  19792.  
  19793.  
  19794.  
  19795.  
  19796.  
  19797.  
  19798.  
  19799.  
  19800.  
  19801.  
  19802.  
  19803.  
  19804.  
  19805.  
  19806.  
  19807.  
  19808.  
  19809.  
  19810.  
  19811.  
  19812.  
  19813.  
  19814.  
  19815.  
  19816.  
  19817.  
  19818.  
  19819.  
  19820.  
  19821.           ___________________________________________________________________
  19822.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  340
  19823.  
  19824.                                              APPENDIX B / ASCII AND KEY CODES
  19825.           ___________________________________________________________________
  19826.  
  19827.  
  19828.  
  19829.  
  19830.  
  19831.  
  19832.  
  19833.  
  19834.  
  19835.  
  19836.  
  19837.  
  19838.  
  19839.  
  19840.  
  19841.  
  19842.  
  19843.  
  19844.  
  19845.  
  19846.  
  19847.  
  19848.  
  19849.  
  19850.  
  19851.  
  19852.  
  19853.  
  19854.  
  19855.  
  19856.  
  19857.  
  19858.  
  19859.  
  19860.  
  19861.  
  19862.  
  19863.  
  19864.  
  19865.  
  19866.  
  19867.  
  19868.  
  19869.  
  19870.  
  19871.  
  19872.  
  19873.  
  19874.  
  19875.  
  19876.  
  19877.  
  19878.           ___________________________________________________________________
  19879.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  341
  19880.  
  19881.                                              APPENDIX B / ASCII AND KEY CODES
  19882.           ___________________________________________________________________
  19883.  
  19884.  
  19885.  
  19886.           Keys and Key Codes
  19887.  
  19888.               When you press a single key or a key combination, software
  19889.               built into your computer (the BIOS or Basic Input / Output
  19890.               System) translates your keystroke into two numbers:  a scan
  19891.               code, representing the actual key that was pressed, and an
  19892.               ASCII code, representing the ASCII value for that key.  The
  19893.               BIOS returns these numbers the next time a program requests
  19894.               keyboard input.  This section explains how key codes work;
  19895.               for information on using them with 4DOS features see 4DOS.INI
  19896.               (page 133), keystroke aliases (page 176), INKEY (page 253),
  19897.               and KEYSTACK (page 257).
  19898.  
  19899.               As PCs have evolved, the structure of keyboard codes has
  19900.               evolved somewhat haphazardly with them, resulting in a
  19901.               bewildering array of possible key codes.  We'll give you a
  19902.               basic explanation of how key codes work.  For a more in-depth
  19903.               discussion, refer to a BIOS or PC hardware reference manual.
  19904.  
  19905.               The nuances of how your keyboard behaves depends on the
  19906.               keyboard manufacturer and the computer manufacturer who
  19907.               provides the built-in BIOS.  As a result, we can't guarantee
  19908.               the accuracy of the information below for every system, but
  19909.               the discussion and reference table should be accurate for most
  19910.               systems.  Our discussion is based on the 101-key "enhanced"
  19911.               keyboard commonly used on AT-compatible and PS/2 computers,
  19912.               but virtually all of it is applicable to the 84-key keyboards
  19913.               on older PC and XT systems.  The primary difference is that
  19914.               the older keyboards lack a separate cursor pad and only have
  19915.               10 function keys.
  19916.  
  19917.               All keys have a scan code.  Not all keys have an ASCII code.
  19918.               For example, function keys and cursor keys are not part of the
  19919.               ASCII character set (see above), and have no ASCII value, but
  19920.               they do have a scan code.  Some keys have more than one ASCII
  19921.               code.  The A key, for example, has ASCII code 97 (lower case
  19922.               "a") if you press it by itself.  If you press it along with
  19923.               the Shift key, the ASCII code changes to 65 (upper case "A").
  19924.               If you press Ctrl and A the ASCII code changes to 1.  In all
  19925.               these cases, the scan code (30) is unchanged because you are
  19926.               pressing the same physical key.
  19927.  
  19928.               Things are different if you press Alt-A.  Alt keystrokes have
  19929.               no ASCII code, so the BIOS returns an ASCII code of 0, along
  19930.               with the A key's scan code of 30.  This allows a program to
  19931.               detect all the possible variations of A, based on the
  19932.               combination of ASCII code and scan code.
  19933.  
  19934.  
  19935.           ___________________________________________________________________
  19936.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  342
  19937.  
  19938.                                              APPENDIX B / ASCII AND KEY CODES
  19939.           ___________________________________________________________________
  19940.  
  19941.  
  19942.               Some keys generate more than one scan code depending on
  19943.               whether Shift, Ctrl, or Alt is pressed.  This allows a program
  19944.               to differentiate between two different keystrokes on the same
  19945.               key, neither of which has a corresponding ASCII value.  For
  19946.               example, F1 has no ASCII value so it returns an ASCII code of
  19947.               0, and the F1 scan code of 59.  Shift-F1 also returns an ASCII
  19948.               code 0;  if it also returned a scan code of 59, a program
  19949.               couldn't distinguish it from F1.  The BIOS translates scan
  19950.               codes for keys like Shift-F1 (and Ctrl-F1 and Alt-F1) so that
  19951.               each variation returns a different scan code along with an
  19952.               ASCII code of 0.
  19953.  
  19954.               On the 101-key keyboard that we're discussing, there's one
  19955.               more variation: non-ASCII keys on the cursor keypad (such as
  19956.               up-arrow) return the same scan code as the corresponding key
  19957.               on the numeric keypad, for compatibility reasons.  If they
  19958.               also returned an ASCII code of 0, a program couldn't tell
  19959.               which key was pressed.  Therefore, these keys return an ASCII
  19960.               code of 224 rather than 0.  This means that older programs,
  19961.               which only look for an ASCII 0 to indicate a non-ASCII
  19962.               keystroke like up-arrow, may not detect these cursor pad keys
  19963.               properly.
  19964.  
  19965.               The number of different codes returned by any given key varies
  19966.               from one (the spacebar) to four, depending on the particular
  19967.               key, the design of your keyboard, and the BIOS in your system.
  19968.               Some keys, like the Alt, Ctrl, and Shift by themselves or in
  19969.               combination with each other, plus the Print Screen, SysReq,
  19970.               Scroll Lock, Pause, Break, Num Lock, and Caps Lock keys, do
  19971.               not have any code representations at all.  The same is true of
  19972.               keystrokes with more than one modifying key, like Ctrl-Shift-
  19973.               A.  The BIOS may perform special actions automatically when
  19974.               you press these keys (for example, it switches into Caps Lock
  19975.               mode when you press Caps Lock), but it does not report the
  19976.               keystrokes to whatever program is running.  Programs which
  19977.               detect such keystrokes access the keyboard hardware directly,
  19978.               a subject which is beyond the scope of this manual.
  19979.  
  19980.               The following table lists all of the keys on the 101-key
  19981.               "enhanced" keyboard.  The keys are arranged roughly in scan
  19982.               code order, which is generally left to right, moving from the
  19983.               top of the keyboard to the bottom.
  19984.  
  19985.               Column 1 shows the key's keycap symbol or name.  Columns 2 and
  19986.               3 show the scan and ASCII code if the key is unshifted.
  19987.               Columns 4 & 5 contain the codes for the shifted key.  Columns
  19988.               6 & 7 show the code for Ctrl plus the key.  The last column
  19989.               contains the scan code for Alt plus the key (Alt keystrokes
  19990.  
  19991.  
  19992.           ___________________________________________________________________
  19993.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  343
  19994.  
  19995.                                              APPENDIX B / ASCII AND KEY CODES
  19996.           ___________________________________________________________________
  19997.  
  19998.  
  19999.               have no ASCII code and always generate an ASCII code of 0,
  20000.               which is not shown).
  20001.  
  20002.               Keys with ASCII values return the same scan code regardless of
  20003.               whether Shift, Ctrl, or Alt is pressed, so the scan code
  20004.               columns below may seem repetitive for these keys.  We've
  20005.               included them in the interest of completeness, since you may
  20006.               need to verify the exact code for a particular key
  20007.               combination.
  20008.  
  20009.               Key names prefaced by np are on the numeric keypad.  Those
  20010.               prefaced by cp are on the cursor keypad between the main
  20011.               typing keys and the number keypad.  The numeric keypad values
  20012.               are valid if Num Lock is turned off.  If you need to specify a
  20013.               number key from the numeric keypad, use the scan code shown
  20014.               for the keypad and the ASCII code shown for the corresponding
  20015.               typewriter key.  For example, the keypad "7" has a scan code
  20016.               of 71 (the np Home scan code) and an ASCII code of 54 (the
  20017.               ASCII code for "7").
  20018.  
  20019.               The chart is blank for key combinations that are not reported
  20020.               at all by the BIOS, like Ctrl-1 and Alt-PgUp.
  20021.  
  20022.  
  20023.  
  20024.  
  20025.  
  20026.  
  20027.  
  20028.  
  20029.  
  20030.  
  20031.  
  20032.  
  20033.  
  20034.  
  20035.  
  20036.  
  20037.  
  20038.  
  20039.  
  20040.  
  20041.  
  20042.  
  20043.  
  20044.  
  20045.  
  20046.  
  20047.  
  20048.  
  20049.           ___________________________________________________________________
  20050.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  344
  20051.  
  20052.                                              APPENDIX B / ASCII AND KEY CODES
  20053.           ___________________________________________________________________
  20054.  
  20055.  
  20056.  
  20057.                     Scan Codes and Key Codes for Top Two Keyboard Rows
  20058.  
  20059.                                                 Shift                                         Shift         Ctrl          Alt                                                              Ctrl
  20060.                 Key Cap    Scan   ASCII         ASCII                                         Scan          Scan          Sca                                                              ASCII
  20061.                 Symbol     Code   Code          Code                                         Code          Code          Cod                                                              Code
  20062.                 -------    -----  -----         -----                                         -----         -----  -----  ---
  20063.                 Esc        1      27            27                                         1             1             1                                                              27
  20064.                 1  !       2      49            33                                         2                           120
  20065.                 2  @       3      50            64                                         3             3             121                                                              0
  20066.                 3  #       4      51            35                                         4                           122
  20067.                 4  $       5      52            36                                         5                           123
  20068.                 5  %       6      53            37                                         6                           124
  20069.                 6  ^       7      54            94                                         7             7             125                                                              30
  20070.                 7  &       8      55            38                                         8                           126
  20071.                 8  *       9      56            42                                         9                           127
  20072.                 9  (       10     57            40                                         10                          128
  20073.                 0  )       11     48            41                                         11                          129
  20074.                 -  _       12     45            95                                         12            12            130                                                              31
  20075.                 =  +       13     61            43                                         13                          131
  20076.                 Backspace  14     8             8                                         14            14            14                                                              127
  20077.                 Tab        15     9             0                                         15            148           165                                                              0
  20078.                 Q          16     113    16     81     16            16                                                              17
  20079.                 W          17     119           87                                         17            17            17                                                              23
  20080.                 E          18     101    18     69     18            18                                                              5
  20081.                 R          19     114    19     82     19            19                                                              18
  20082.                 T          20     116    20     84     20            20                                                              20
  20083.                 Y          21     121    21     89     21     25     21
  20084.                 U          22     117    22     85     22     21     22
  20085.                 I          23     105    23     73     23            23                                                              9
  20086.                 O          24     111           79                                         24            24     15     24
  20087.                 P          25     112           80                                         25            25     16     25
  20088.                 [  {       26     91            123                                         26            26     27     26
  20089.                 ]  }       27     93     27     125    27            27                                                              29
  20090.                 Enter      28     13     28     13     28            28                                                              10
  20091.  
  20092.  
  20093.  
  20094.  
  20095.  
  20096.  
  20097.  
  20098.  
  20099.  
  20100.  
  20101.  
  20102.  
  20103.  
  20104.  
  20105.  
  20106.           ___________________________________________________________________
  20107.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  345
  20108.  
  20109.                                              APPENDIX B / ASCII AND KEY CODES
  20110.           ___________________________________________________________________
  20111.  
  20112.  
  20113.  
  20114.                    Scan Codes and Key Codes for Bottom Two Keyboard Rows
  20115.  
  20116.                                                 Shift                                         Shift         Ctrl          Alt                                                              Ctrl
  20117.                 Key Cap    Scan   ASCII         ASCII                                         Scan          Scan          Sca                                                              ASCII
  20118.                 Symbol     Code   Code          Code                                         Code          Code          Cod                                                              Code
  20119.                 -------    -----  -----         -----                                         -----         -----  -----  ---
  20120.                 A          30     97            65                                         30            30            30                                                              1
  20121.                 S          31     115           83                                         31            31            31                                                              19
  20122.                 D          32     100           68                                         32            32            32                                                              4
  20123.                 F          33     102           70                                         33            33     6      33
  20124.                 G          34     103           71                                         34            34            34                                                              7
  20125.                 H          35     104           72                                         35            35            35                                                              8
  20126.                 J          36     106           74                                         36            36            36                                                              10
  20127.                 K          37     107           75                                         37            37            37                                                              11
  20128.                 L          38     108           76                                         38            38            38                                                              12
  20129.                 ;  :       39     59            58                                         39                          39
  20130.                 '  "       40     39            34                                         40                          40
  20131.                 `  ~       41     96            126                                         41                          41
  20132.                 \  |       43     92            124                                         43            43            43                                                              28
  20133.                 Z          44     122    44     90     44            44                                                              26
  20134.                 X          45     120    45     88     45            45                                                              24
  20135.                 C          46     99            67                                         46            46     3      46
  20136.                 V          47     118    47     86     47            47                                                              22
  20137.                 B          48     98     48     66     48     2      48
  20138.                 N          49     110           78                                         49            49     14     49
  20139.                 M          50     109           77                                         50            50            50                                                              13
  20140.                 ,  <       51     44     51     60                   51
  20141.                 .  >       52     46     52     62                   52
  20142.                 /  ?       53     47            63                                         53                          53
  20143.                 Space      57     32            32                                         57            57     32     57
  20144.  
  20145.  
  20146.  
  20147.  
  20148.  
  20149.  
  20150.  
  20151.  
  20152.  
  20153.  
  20154.  
  20155.  
  20156.  
  20157.  
  20158.  
  20159.  
  20160.  
  20161.  
  20162.  
  20163.           ___________________________________________________________________
  20164.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  346
  20165.  
  20166.                                              APPENDIX B / ASCII AND KEY CODES
  20167.           ___________________________________________________________________
  20168.  
  20169.  
  20170.                   Scan Codes and Key Codes for Key Pads and Function Keys
  20171.  
  20172.                                                 Shift                                         Shift         Ctrl          Alt                                                              Ctrl
  20173.                 Key Cap    Scan   ASCII         ASCII                                         Scan          Scan          Sca                                                              ASCII
  20174.                 Symbol     Code   Code          Code                                         Code          Code          Cod                                                              Code
  20175.                 -------    -----  -----         -----                                         -----         -----  -----  ---
  20176.                 F1         59     0             0                                         84            94            104                                                              0
  20177.                 F2         60     0             0                                         85            95            105                                                              0
  20178.                 F3         61     0             0                                         86            96            106                                                              0
  20179.                 F4         62     0             0                                         87            97     0      107
  20180.                 F5         63     0             0                                         88            98            108                                                              0
  20181.                 F6         64     0             0                                         89            99            109                                                              0
  20182.                 F7         65     0             0                                         90            100           110                                                              0
  20183.                 F8         66     0             0                                         91            101           111                                                              0
  20184.                 F9         67     0             0                                         92            102           112                                                              0
  20185.                 F10        68     0             0                                         93            103           113                                                              0
  20186.                 F11        133    0             0                                         135           137           139                                                              0
  20187.                 F12        134    0             0                                         136           138    0      140
  20188.                 np *       55     42            42                                         55            150           55                                                              0
  20189.                 np Home    71     0             55                                         71            119    0
  20190.                 cp Home    71     224           224                                         71            119           151                                                              224
  20191.                 np Up      72     0             56                                         72            141    0
  20192.                 cp Up      72     224           224                                         72            141           152                                                              224
  20193.                 np PgUp    73     0             57                                         73            132    0
  20194.                 cp PgUp    73     224           224                                         73            132           153                                                              224
  20195.                 np Minus   74     45            45                                         74            142           74                                                              0
  20196.                 np Left    75     0             52                                         75            115    0
  20197.                 cp Left    75     224           224                                         75            115           155                                                              224
  20198.                 np 5       76     0             53                                         76            143    0
  20199.                 np Right   77     0      77     54     116    0
  20200.                 cp Right   77     224    77     224    116           157                                                              224
  20201.                 np Plus    78     43     78     43     144    0      78
  20202.                 np End     79     0      79     49     117    0
  20203.                 cp End     79     224    79     224    117           159                                                              224
  20204.                 np Down    80     0      80     50     145    0
  20205.                 cp Down    80     224    80     224    145    224    160
  20206.                 np PgDn    81     0      81     51     118    0
  20207.                 cp PgDn    81     224    81     224    118           161                                                              224
  20208.                 np Ins     82     0      82     48     146    0
  20209.                 cp Ins     82     224           224                                         82            146           162                                                              224
  20210.                 np Del     83     0             46                                         83            147    0
  20211.                 cp Del     83     224    83     224    147    224    163
  20212.                 np /       224    47            47                                         224           149    0      164
  20213.                 np Enter   224    13            13                                         224           224    10     166
  20214.  
  20215.  
  20216.  
  20217.  
  20218.  
  20219.  
  20220.           ___________________________________________________________________
  20221.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  347
  20222.  
  20223.                                            APPENDIX C / TECHNICAL INFORMATION
  20224.           ___________________________________________________________________
  20225.  
  20226.  
  20227.  
  20228.           APPENDIX C / TECHNICAL INFORMATION
  20229.  
  20230.  
  20231.           This appendix provides technical information for programmers who
  20232.           wish to build interfaces to 4DOS.  It covers detecting 4DOS,
  20233.           placing keystrokes in the Keystack, writing installable commands,
  20234.           using the DESCRIPT.ION file, and using the interrupt 2E "back door"
  20235.           entry into 4DOS to execute commands.
  20236.  
  20237.  
  20238.           Detecting 4DOS
  20239.  
  20240.  
  20241.               Detecting 4DOS From a Batch File
  20242.  
  20243.               From a batch file, you can determine if 4DOS is loaded by
  20244.               testing for the variable function @EVAL, with a test like
  20245.               this:
  20246.  
  20247.                    if "%@eval[2+2]" == "4" echo 4DOS is loaded!
  20248.  
  20249.               This test can never succeed in COMMAND.COM and is therefore a
  20250.               reliable way to detect 4DOS.  Other variable functions could
  20251.               be used for the same purpose.
  20252.  
  20253.  
  20254.               Detecting 4DOS From a Program
  20255.  
  20256.               Any program can test for the presence of 4DOS by making a
  20257.               simple INT 2Fh call.  Be sure to check the INT 2Fh vector
  20258.               first as it may be 0 under some versions of DOS 2 if no
  20259.               program has hooked the interrupt.  To detect 4DOS, call INT
  20260.               2Fh with:
  20261.  
  20262.                     AX = D44Dh
  20263.                     BX = 0
  20264.  
  20265.               If 4DOS is not loaded, AX should be returned unchanged.  If
  20266.               4DOS is loaded, it will return the following (no other
  20267.               registers are modified):
  20268.  
  20269.                     AX = 44DDh
  20270.                     BX = Version number (BL = major version, BH = minor
  20271.                          version)
  20272.                     CX = 4DOS PSP segment address
  20273.                     DL = 4DOS shell number
  20274.  
  20275.  
  20276.  
  20277.           ___________________________________________________________________
  20278.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  348
  20279.  
  20280.                                            APPENDIX C / TECHNICAL INFORMATION
  20281.           ___________________________________________________________________
  20282.  
  20283.  
  20284.               The shell number is incremented each time a new copy of 4DOS
  20285.               is loaded, either in a different multitasker window (for
  20286.               example, under DESQview), or via nested shells.  The primary
  20287.               shell is shell number 0.
  20288.  
  20289.               This function tells you if 4DOS is loaded in memory, but not
  20290.               whether it is the parent process of your program.  You can
  20291.               determine if 4DOS is the parent process by comparing the PSP
  20292.               value returned in CX to the PSP chain pointer at offset 16h in
  20293.               your program's PSP.
  20294.  
  20295.  
  20296.               Detecting the 4DOS Prompt
  20297.  
  20298.               4DOS generates INT 2Fh calls before and after the prompt is
  20299.               displayed to allow TSRs to detect that 4DOS is at the prompt.
  20300.               The calls are:
  20301.  
  20302.                     AX = D44Eh
  20303.                     BX = 0:  4DOS is about to display the prompt
  20304.                          1:  4DOS is about to accept input at the prompt
  20305.                          2:  keyboard input is complete and 4DOS is about to
  20306.                          begin processing the line
  20307.  
  20308.               The BX = 0 call occurs immediately before displaying the
  20309.               prompt; the BX = 1 call occurs after displaying the prompt and
  20310.               immediately before accepting keyboard input; and the BX = 2
  20311.               call occurs immediately after 4DOS receives the CR (Enter)
  20312.               keystroke, but before the line is processed.  Any routine
  20313.               intercepting these calls should preserve the SI, DI, BP, SP,
  20314.               DS, ES, and SS registers.
  20315.  
  20316.  
  20317.           Placing Keystrokes Into the Keystack
  20318.  
  20319.               You can put keystrokes into the 4DOS Keystack with an INT 2Fh
  20320.               call.  First, you must make a call to check whether KSTACK.COM
  20321.               is loaded:
  20322.  
  20323.                    AX =  D44Fh
  20324.                    BX =  0
  20325.  
  20326.               If KSTACK.COM is not loaded, this call will return AX
  20327.               unchanged.  If it is loaded, AX will be returned as 44DDh;
  20328.               other registers will be unchanged.  Once you have determined
  20329.               that KSTACK.COM is loaded, you can send keystrokes with this
  20330.               call:
  20331.  
  20332.  
  20333.  
  20334.           ___________________________________________________________________
  20335.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  349
  20336.  
  20337.                                            APPENDIX C / TECHNICAL INFORMATION
  20338.           ___________________________________________________________________
  20339.  
  20340.  
  20341.                     AX = D44Fh
  20342.                     BX = 1
  20343.                     CX = number of keystrokes being passed
  20344.                     DS:DX = address of the keystroke array
  20345.  
  20346.               On return, if the call succeeded then AX will be 0; if it
  20347.               failed, AX will be non-zero.  BX, CX, and DX are destroyed;
  20348.               other registers are preserved.  If the call succeeds,
  20349.               subsequent calls to INT 16h functions 0, 1, 10h, or 11h will
  20350.               receive the stacked keystrokes.
  20351.  
  20352.               The keystroke array passed to KSTACK must be an array of words
  20353.               containing the values to return from INT 16h.  The high byte
  20354.               of each word is a scan code and the low byte is an ASCII code.
  20355.               Many programs accept keystrokes properly with only the ASCII
  20356.               code, but some require the scan code as well.  See page 342
  20357.               for a list of ASCII and scan codes for most keyboards.  To
  20358.               insert a delay in the keystroke sequence, include a word set
  20359.               to FFFFh followed by a word containing the desired delay in
  20360.               clock ticks.
  20361.  
  20362.  
  20363.           Writing Installable Commands
  20364.  
  20365.               An "installable command" is created with a memory-resident
  20366.               program (TSR) which can receive signals from 4DOS and process
  20367.               commands.  4DOS makes every command available to such TSRs
  20368.               before it is executed; if any TSR chooses to execute the
  20369.               command, 4DOS will do no further processing.  Otherwise, 4DOS
  20370.               processes the command normally.
  20371.  
  20372.               The 4DOS "Installable command" interface is compatible with an
  20373.               undocumented interface present in COMMAND.COM for MS-DOS and
  20374.               PC-DOS 3.3 and above.  This interface is documented more
  20375.               thoroughly on pages 373 - 379 of the excellent reference text
  20376.               Undocumented DOS by Schulman et. al., published by Addison
  20377.               Wesley (ISBN 0-201-57064-5).
  20378.  
  20379.               4DOS looks for an installable command after alias expansion
  20380.               and after checking to see if the command is a drive change,
  20381.               but before checking for an internal or external command.
  20382.  
  20383.               4DOS first makes an INT 2Fh call to determine whether any TSR
  20384.               loaded will respond to the command, with:
  20385.  
  20386.                     AX = AE00h
  20387.                     BX = offset of command line buffer:
  20388.                            first byte = maximum length of command line (128)
  20389.  
  20390.  
  20391.           ___________________________________________________________________
  20392.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  350
  20393.  
  20394.                                            APPENDIX C / TECHNICAL INFORMATION
  20395.           ___________________________________________________________________
  20396.  
  20397.  
  20398.                            second byte = actual length of command line, not
  20399.                               including trailing CR
  20400.                            remainder = command line, with a trailing CR
  20401.                     CH = FFh
  20402.                     CL = length of command line, not including the command
  20403.                          name
  20404.                     DX = FFFFh
  20405.                     SI = offset of command name buffer:
  20406.                            first byte = length of command name
  20407.                            remainder = command name, shifted to upper case
  20408.                               and padded with blanks to 11 characters
  20409.                     DI = 0
  20410.  
  20411.               If the TSR does not recognize the command as its own, it must
  20412.               pass the INT 2Fh along with registers unchanged.  If it does
  20413.               recognize the command, it must return 0FFh in AL.  The command
  20414.               should not be executed at this point.  4DOS will then make
  20415.               another call (buffer formats are the same as above):
  20416.  
  20417.                     AX = AE01h
  20418.                     BX = offset of command line buffer
  20419.                     CH = 0
  20420.                     CL = length of command name
  20421.                     DX = FFFFh
  20422.                     SI = offset of command name buffer
  20423.  
  20424.               If the TSR executed the command line, it must set the command
  20425.               name length (DS:[SI]) to 0.  If the command name length is not
  20426.               0, 4DOS will attempt to execute the command as an internal or
  20427.               external command.  This allows the TSR to return a modified
  20428.               command line to 4DOS by modifying the command line buffer at
  20429.               DS:BX, and leaving the command name length byte at DS:[SI] set
  20430.               to a non-zero value.  If the command is executed, the TSR
  20431.               should return the result of the command (zero for normal
  20432.               return or non-zero for an error) in AL.
  20433.  
  20434.  
  20435.           Using DESCRIPT.ION
  20436.  
  20437.               4DOS uses the file DESCRIPT.ION to store file descriptions.
  20438.               This file is created as a hidden file in each subdirectory
  20439.               which has descriptions, and deleted when all descriptions are
  20440.               removed or when all files with descriptions are deleted.
  20441.  
  20442.               Your programs can access DESCRIPT.ION to create, retrieve, or
  20443.               modify file descriptions, and to store other information.
  20444.               DESCRIPT.ION has one line per file, and is unsorted.  Each
  20445.               line is in the following format:
  20446.  
  20447.  
  20448.           ___________________________________________________________________
  20449.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  351
  20450.  
  20451.                                            APPENDIX C / TECHNICAL INFORMATION
  20452.           ___________________________________________________________________
  20453.  
  20454.  
  20455.                    filename.ext Description[*<ID>Other program info]...<CR>
  20456.  
  20457.               There is normally one space between the description and
  20458.               filename but additional spaces may be used in future versions
  20459.               of 4DOS.  The characters after the description allow extension
  20460.               of the description format for use by other programs.  They are
  20461.               as follows:
  20462.  
  20463.                    * represents an ASCII Ctrl-D (04), and marks the end of
  20464.                    the description text and the beginning of information for
  20465.                    a program other than 4DOS.  This symbol can appear
  20466.                    multiple times on each line; each occurrence marks the
  20467.                    beginning of information for another program.
  20468.  
  20469.                    <ID> is an identification byte for the program which is
  20470.                    using this area of the particular line.  If you are
  20471.                    writing a program which will store information in
  20472.                    DESCRIPT.ION, test it using an ID byte of your own
  20473.                    choosing.  When you are ready to release the program,
  20474.                    contact JP Software and we will provide you with an ID
  20475.                    byte value that is not in use by others to the best of
  20476.                    our knowledge.
  20477.  
  20478.                    Other program info is any text the program wishes to
  20479.                    store in its area of the line.  The text should relate
  20480.                    specifically to the file named on the line.  It may not
  20481.                    contain the Ctrl-D character, carriage returns, line
  20482.                    feeds, or nulls (ASCII 0s).
  20483.  
  20484.               4DOS will copy, delete, or move all the information on a line
  20485.               in DESCRIPT.ION, including information owned by other
  20486.               programs, when performing the same action on the corresponding
  20487.               file.  4DOS will also change the name if a file is renamed.
  20488.               To support DESCRIPT.ION properly, your program must do the
  20489.               same if it copies, deletes, moves, or renames files.  Take
  20490.               care not to remove information which does not belong to your
  20491.               program, or delete lines which contain information for other
  20492.               programs.  Your program should be able to handle a line
  20493.               terminated by a CR or LF alone, a CR/LF pair, an EOF (ASCII
  20494.               26), or the physical end of the file.  The lines it creates
  20495.               should be terminated with CR / LF.  The line length limit is
  20496.               4096 bytes; exceeding this limit will cause unpredictable
  20497.               results.
  20498.  
  20499.  
  20500.  
  20501.  
  20502.  
  20503.  
  20504.  
  20505.           ___________________________________________________________________
  20506.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  352
  20507.  
  20508.                                            APPENDIX C / TECHNICAL INFORMATION
  20509.           ___________________________________________________________________
  20510.  
  20511.  
  20512.           Interrupt 2E
  20513.  
  20514.               4DOS provides full, documented support for the undocumented
  20515.               COMMAND.COM "back door" entry, INT 2E (hex).  INT 2E allows
  20516.               applications to call the primary copy of the command processor
  20517.               to execute commands, without loading a secondary shell.
  20518.  
  20519.               INT 2E support is enabled with the FullINT2E = Yes directive
  20520.               in 4DOS.INI.  If this directive is left out or is set to No,
  20521.               4DOS does "hook" INT 2E, but any calls to it are ignored.
  20522.               Setting FullINT2E = Yes adds about 100 bytes to the resident
  20523.               size of 4DOS, and applies only to the primary shell (it is
  20524.               ignored in secondary shells).
  20525.  
  20526.               To use INT 2E, set DS:SI to the address of a buffer containing
  20527.               the command, then issue an INT 2E.  The buffer format is:
  20528.  
  20529.                    First byte      Length of command, not including this
  20530.                                    byte or the last byte
  20531.                    Text bytes      The command text
  20532.                    Last byte       CR (ASCII 13)
  20533.  
  20534.               You must have enough memory available for 4DOS to reload its
  20535.               transient portion, and about 80 bytes of available stack space
  20536.               for the INT 2E handler to use.  INT 2E can not be called from
  20537.               a TSR while 4DOS is running (for example, a TSR popped up at
  20538.               the 4DOS prompt or from within LIST or SELECT), but can be
  20539.               called from within any application or from within a TSR while
  20540.               an application (including the 4DOS HELP system) is running.
  20541.  
  20542.               INT 2E can invoke any 4DOS command including an alias, an
  20543.               internal command, an external command, or a batch file.  All
  20544.               changes to 4DOS data (such as aliases, environment variables,
  20545.               and SETDOS settings) which are made by a command executed via
  20546.               INT 2E calls will affect the primary shell, and the
  20547.               environment passed to a program called via INT 2E will be a
  20548.               copy of the primary shell's environment.
  20549.  
  20550.               INT 2E uses the same internal stack (temporary storage area)
  20551.               as the primary shell.  If a complex command is used in the
  20552.               primary shell to start a program which eventually issues an
  20553.               INT 2E, the additional stack space required by commands
  20554.               executed through INT 2E may (in rare circumstances) cause a
  20555.               stack overflow.  If this occurs, use the StackSize directive
  20556.               in 4DOS.INI (see page 141) to increase 4DOS's internal stack
  20557.               space.
  20558.  
  20559.  
  20560.  
  20561.  
  20562.           ___________________________________________________________________
  20563.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  353
  20564.  
  20565.                                            APPENDIX C / TECHNICAL INFORMATION
  20566.           ___________________________________________________________________
  20567.  
  20568.  
  20569.               INT 2E also uses the same batch file "stack" as the primary
  20570.               shell.  This means that if INT 2E is used to execute a batch
  20571.               file, this batch file is considered "nested" within any batch
  20572.               file(s) used in the primary shell to start the program which
  20573.               issued the INT 2E.  This may cause batch nesting errors from
  20574.               within the INT 2E call which would not occur if the same
  20575.               command were executed at the prompt.  For example, suppose an
  20576.               application is loaded from batch files nested six levels deep,
  20577.               and that application uses INT 2E to execute a command which
  20578.               invokes batch files which nest to five levels deep.  Under
  20579.               these conditions a nesting error will occur, because the total
  20580.               nesting level is eleven, exceeding 4DOS's limit of ten levels
  20581.               of nested batch files.
  20582.  
  20583.               On return from INT 2E all registers will be destroyed except
  20584.               SS and SP.  AX will be set as follows:
  20585.  
  20586.                  FFFFh   An error occurred before processing the command: not
  20587.                          enough memory was available, INT 2E was called from
  20588.                          a TSR, or another error made it impossible to handle
  20589.                          the interrupt.
  20590.  
  20591.                  0       The command was processed without error.
  20592.  
  20593.                  > 0     There was an error in processing the command.  AX is
  20594.                          the error number, equivalent to the IERRORLEVEL
  20595.                          (%_?) value from an internal command or the
  20596.                          ERRORLEVEL (%?) value from an external command.  If
  20597.                          a batch file is run the value will be the error
  20598.                          level returned by the batch file (via QUIT n or
  20599.                          CANCEL n) or the last command within it.  If an
  20600.                          alias is run the value will be the error level
  20601.                          returned by the last command in the alias.
  20602.  
  20603.  
  20604.  
  20605.  
  20606.  
  20607.  
  20608.  
  20609.  
  20610.  
  20611.  
  20612.  
  20613.  
  20614.  
  20615.  
  20616.  
  20617.  
  20618.  
  20619.           ___________________________________________________________________
  20620.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  354
  20621.  
  20622.                                                                      GLOSSARY
  20623.           ___________________________________________________________________
  20624.  
  20625.  
  20626.  
  20627.           GLOSSARY
  20628.  
  20629.  
  20630.           Some items in this glossary refer to 4DOS features.  For more
  20631.           information on how a particular feature works, look the feature up
  20632.           in the index under the name used here.
  20633.  
  20634.               4DOS.INI:  The 4DOS initialization file containing directives
  20635.               which set 4DOS's startup configuration parameters.
  20636.  
  20637.               4EXIT:  A batch file which is executed whenever a secondary
  20638.               4DOS shell ends.
  20639.  
  20640.               4START:  A batch file which is executed whenever 4DOS is
  20641.               started, either as a primary shell or a secondary shell.
  20642.  
  20643.               Alias:  A shorthand name for a command or series of commands.
  20644.  
  20645.               Alias Argument:  A numeric variable included in an alias
  20646.               definition, allowing a different value to be used in the alias
  20647.               each time it is executed.
  20648.  
  20649.               AND:  A logical combination of two true or false conditions
  20650.               such that if both conditions are true the result is true; if
  20651.               either condition is false the result is false.
  20652.  
  20653.               ANSI.SYS:  A device driver supplied with DOS which provides
  20654.               enhanced screen display and keyboard macros, or one of the
  20655.               many similar programs.
  20656.  
  20657.               Append:  Concatenation of one file or string onto the end of
  20658.               another.  (There is also a DOS external command, APPEND, which
  20659.               has an entirely different meaning and which should be used
  20660.               with caution!)
  20661.  
  20662.               Application:  A program run from the command prompt or a batch
  20663.               file.  The term is used broadly to mean any program other than
  20664.               the command processor; and more narrowly to mean a program
  20665.               with a specific purpose such as a spreadsheet or word
  20666.               processing program, as opposed to a utility.
  20667.  
  20668.               Archive:  A file attribute indicating that the file has been
  20669.               modified since the last backup (presuming that the last backup
  20670.               cleared the archive attribute, as most backup programs do).
  20671.               Also sometimes used to refer to a single file which contains a
  20672.               number of other files in compressed form.
  20673.  
  20674.  
  20675.  
  20676.           ___________________________________________________________________
  20677.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  355
  20678.  
  20679.                                                                      GLOSSARY
  20680.           ___________________________________________________________________
  20681.  
  20682.  
  20683.               Argument:  A piece of additional information placed after a
  20684.               command or function name.  For example in the command DIR XYZ,
  20685.               XYZ is an argument.  Also used to refer to an alias argument
  20686.               or batch file argument.
  20687.  
  20688.               ASCII:  The American Standard Code for Information
  20689.               Interchange, which defines numeric values for 128 different
  20690.               characters comprising the English alphabet, numbers,
  20691.               punctuation, and some control characters.
  20692.  
  20693.               ASCII File:  A file containing ASCII text, as opposed to a
  20694.               binary file which may contain codes, numbers, or other
  20695.               information that cannot be sensibly interpreted as text.
  20696.  
  20697.               Attribute:  A characteristic of a file which can be set or
  20698.               cleared.  The standard attributes are Read-Only, Hidden,
  20699.               System, and Archive.  The special attributes Volume Label and
  20700.               Directory are also used for files of those types.
  20701.  
  20702.               AUTOEXEC.BAT:  A batch file which is AUTOmatically EXECuted
  20703.               when the computer is started.
  20704.  
  20705.               Automatic Directory Change:  A 4DOS feature which allows
  20706.               changing directories by typing the directory name and a
  20707.               backslash [\] at the prompt.
  20708.  
  20709.               Base Memory:  The portion of your computer's memory available
  20710.               for use by DOS, the command processor, and application
  20711.               programs.  On most PCs this area consists of the first 640K
  20712.               bytes of the computer's memory (one K is 1024 bytes).
  20713.  
  20714.               BAT File:  Same as a Batch File.
  20715.  
  20716.               Batch File:  A text file containing a sequence of DOS or 4DOS
  20717.               commands.  Batch files are used to save command sequences so
  20718.               that they can be re-executed at any time, transferred to
  20719.               another system, etc.
  20720.  
  20721.               Batch File Argument:  A numeric variable used within a batch
  20722.               file, allowing a different value to be used at that spot in
  20723.               the file each time it is executed.
  20724.  
  20725.               Binary File:  A file containing information which does not
  20726.               represent or cannot sensibly be interpreted as text.  See also
  20727.               ASCII File.
  20728.  
  20729.               Block Device:  A physical device for input or output which can
  20730.               transmit or receive large blocks of data while the computer is
  20731.  
  20732.  
  20733.           ___________________________________________________________________
  20734.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  356
  20735.  
  20736.                                                                      GLOSSARY
  20737.           ___________________________________________________________________
  20738.  
  20739.  
  20740.               engaged in other activities.  Examples include disk, tape, and
  20741.               CD-ROM drives, and many networks.
  20742.  
  20743.               Boot:  The process of starting the computer and loading DOS
  20744.               and the command processor into memory.
  20745.  
  20746.               Boot Directory:  The current directory at the time the system
  20747.               is booted, almost always the root directory of the boot drive.
  20748.  
  20749.               Boot Drive:  The disk drive that the system is booted from,
  20750.               usually A: (the floppy disk) or C: (the hard disk).
  20751.  
  20752.               Break: A signal sent to a program (including 4DOS) to tell it
  20753.               to halt what it is doing.  The Ctrl-C key  or Ctrl-Break key
  20754.               is used to send this signal.  Some external commands abort
  20755.               when they receive a break signal; others return to a previous
  20756.               screen or menu, or abort the current operation.
  20757.  
  20758.               BTM File:  A special type of batch file which is loaded into
  20759.               memory, dramatically speeding up execution.
  20760.  
  20761.               Buffer:  An area of memory set aside for storage.  Usually
  20762.               refers to disk buffers, used to save information as it is
  20763.               transferred between your program and the disk; or to the
  20764.               keyboard buffer, which holds keystrokes until a program can
  20765.               use them.
  20766.  
  20767.               Character Device:  A physical device for input or output which
  20768.               must communicate with your computer one character at a time.
  20769.               Examples include the console, communications ports, and
  20770.               printers.
  20771.  
  20772.               Code Page:  A set of definitions which tells DOS how to get
  20773.               and display date, time, and other information in the format
  20774.               appropriate to a particular country.
  20775.  
  20776.               Command Completion:  A 4DOS feature which allows you to recall
  20777.               a previous command by typing the first few letters of the
  20778.               command, then an up-arrow or down-arrow.
  20779.  
  20780.               Command Echoing:  A feature which displays commands as they
  20781.               are executed.  Echoing can be turned on and off.
  20782.  
  20783.               Command History:  A 4DOS feature which retains commands you
  20784.               have previously executed, so that they can be modified and re-
  20785.               executed later.
  20786.  
  20787.  
  20788.  
  20789.  
  20790.           ___________________________________________________________________
  20791.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  357
  20792.  
  20793.                                                                      GLOSSARY
  20794.           ___________________________________________________________________
  20795.  
  20796.  
  20797.               Command Interpreter:  A program, such as 4DOS or COMMAND.COM,
  20798.               which interprets commands and executes other programs.
  20799.  
  20800.               Command Recall:  See Command History.
  20801.  
  20802.               Command Tail:  The portion of a command consisting of all the
  20803.               arguments, i.e. everything but the command name itself.
  20804.  
  20805.               Compound Command:  See Multiple Commands.
  20806.  
  20807.               COMSPEC:  An environment variable which defines where to get
  20808.               the command processor for a secondary shell.
  20809.  
  20810.               Conditional Commands:  A 4DOS feature allowing commands to be
  20811.               executed or skipped depending on the results of a previous
  20812.               command.   See also Exit Code.
  20813.  
  20814.               CONFIG.SYS:  A file which tells DOS what device drivers to
  20815.               install, what command processor to use, and other information
  20816.               about what to do when your system boots.  See your DOS manual
  20817.               for more information.
  20818.  
  20819.               Console:  The PC keyboard and display.
  20820.  
  20821.               Control Character:  A character which is part of the ASCII
  20822.               code, but does not have a normal text representation, and
  20823.               which can be generated by pressing the Ctrl key along with
  20824.               another key.  For example the control character called "BEL"
  20825.               is generated by pressing Ctrl-G, and will cause the computer
  20826.               to beep if pressed at the DOS prompt.
  20827.  
  20828.               Country Code:  See Code Page.
  20829.  
  20830.               CR:  The ASCII character "carriage return", generated by
  20831.               pressing the "Enter" key on the keyboard, and stored in most
  20832.               ASCII files at the end of each line.
  20833.  
  20834.               Critical Error:  An error, usually related to input, output,
  20835.               or network access, which prevents a program from continuing.
  20836.               When a critical error occurs, a prompt such as "R(etry),
  20837.               I(gnore), F(ail), or A(bort)" appears on the screen and you
  20838.               must decide what action to take.
  20839.  
  20840.               Current Directory:  The directory in which all file operations
  20841.               will take place unless otherwise specified.  For example if
  20842.               the current directory is C:\MYFILES then the command "DEL XYZ"
  20843.               will delete the file XYZ in the directory C:\MYFILES, and will
  20844.  
  20845.  
  20846.  
  20847.           ___________________________________________________________________
  20848.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  358
  20849.  
  20850.                                                                      GLOSSARY
  20851.           ___________________________________________________________________
  20852.  
  20853.  
  20854.               not affect other files with the same name which may be in
  20855.               other directories.
  20856.  
  20857.               Description:  A string of characters assigned to describe a
  20858.               file with the 4DOS DESCRIBE command.
  20859.  
  20860.               Destination:  In the 4DOS file commands (COPY, MOVE, and
  20861.               RENAME), the name or directory files should have after any
  20862.               copying or modification has taken place; generally referred to
  20863.               by the last specification on the command line.  See also
  20864.               Source.
  20865.  
  20866.               Device:  A physical device for input or output such as the
  20867.               console, a communications port, or a printer.  Sometimes the
  20868.               term "device" alone is used to refer to character devices such
  20869.               as those listed above, and excludes block devices.
  20870.  
  20871.               Device Driver:  A program which allows DOS to communicate with
  20872.               a device, and which is loaded into memory when the system is
  20873.               booted, via a statement in CONFIG.SYS.  Some device drivers
  20874.               are used to manage memory or for other similar internal
  20875.               functions, rather than to communicate with an external device.
  20876.  
  20877.               Directory:  A portion of any disk, identified by a name and a
  20878.               relationship to other directories in a "tree" structure, with
  20879.               the tree starting at the root directory.  A directory
  20880.               separates files on the disk into logical groups, but does not
  20881.               represent a physical division of the data on the disk.
  20882.  
  20883.               Disk Swapping:  A type of swapping in which the transient
  20884.               portion of 4DOS is stored on disk while an application is
  20885.               running.
  20886.  
  20887.               DOS Memory:  See Base Memory.
  20888.  
  20889.               Echo:  See Command Echoing.
  20890.  
  20891.               EMS Memory:  Memory which conforms to the Lotus - Intel -
  20892.               Microsoft Expanded Memory Specification (LIM EMS).  This
  20893.               hardware/software standard allows programs to access large
  20894.               amounts of memory outside of base memory or extended memory.
  20895.               Most systems which have EMS memory have either a specific EMS
  20896.               board (on any PC or compatible system), EMS emulation software
  20897.               (on PC-AT compatible systems), or a 386 control program such
  20898.               as QEMM or 386MAX (on 386 systems).  If you do not have one of
  20899.               these items, you probably do not have EMS memory.
  20900.  
  20901.  
  20902.  
  20903.  
  20904.           ___________________________________________________________________
  20905.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  359
  20906.  
  20907.                                                                      GLOSSARY
  20908.           ___________________________________________________________________
  20909.  
  20910.  
  20911.               EMS Swapping:  A type of swapping in which the transient
  20912.               portion of 4DOS is stored in EMS memory while an application
  20913.               is running.
  20914.  
  20915.               Environment:  An area of memory which contains multiple
  20916.               entries in the form "NAME=value".  Each entry is called an
  20917.               environment variable.  See also Master Environment and Passed
  20918.               Environment.
  20919.  
  20920.               Environment Variable:  The name of a single entry in the
  20921.               environment.  Environment variables are entered with the SET
  20922.               command, and used to associate the specified value with the
  20923.               specified name for any purpose desired by the user.
  20924.               Typically, their function is to set default switches for a
  20925.               program, specify a directory path where files can be found,
  20926.               and so on.  When 4DOS encounters an environment variable name
  20927.               in a command in the form "%NAME" (or "%NAME%"), it substitutes
  20928.               the corresponding value in its place.
  20929.  
  20930.               Errorlevel:  A numeric value between 0 and 255 returned from
  20931.               an external command to indicate its result (e.g., success,
  20932.               failure, response to a question), and accessible via the IF
  20933.               ERRORLEVEL command and the %? environment variable.  See also
  20934.               Exit Code.
  20935.  
  20936.               Escape Character:  This term has two meanings.  In some
  20937.               contexts it means the 4DOS escape character, normally Ctrl-X,
  20938.               which is used to suppress the normal meaning of or give
  20939.               special meaning to the following character.  In other cases it
  20940.               refers to the specific ASCII character ESC.  The meaning must
  20941.               be determined from the context.
  20942.  
  20943.               Executable Extensions:  A 4DOS feature which allows you to
  20944.               specify the application to be executed when a file with a
  20945.               particular extension is named at the command prompt.
  20946.  
  20947.               Executable File:  A file with the extension .COM or .EXE,
  20948.               which can be loaded into memory and run as a program.
  20949.  
  20950.               Exit Code:  The error level returned by an external command,
  20951.               or a similar exit code returned by a 4DOS internal command.
  20952.               4DOS internal commands return an exit code of 0 if successful,
  20953.               or non-zero if unsuccessful.  See also Errorlevel.
  20954.  
  20955.               Expansion:  The process 4DOS goes through when it scans a
  20956.               command line and substitutes the appropriate actual values for
  20957.               aliases, alias arguments, batch file arguments, and
  20958.               environment variables.  See also Parsing.
  20959.  
  20960.  
  20961.           ___________________________________________________________________
  20962.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  360
  20963.  
  20964.                                                                      GLOSSARY
  20965.           ___________________________________________________________________
  20966.  
  20967.  
  20968.               Extended ASCII Character:  A character which is not part of
  20969.               the standard set of 128 ASCII characters, but is used on the
  20970.               PC as part of an extended set of 256 characters.  These
  20971.               characters include international language symbols, and box and
  20972.               line drawing characters.
  20973.  
  20974.               Extended Memory:  Any memory on a 286-based (PC-AT compatible)
  20975.               or 386-based computer system which is above the 1 MB (one
  20976.               megabyte, or 1024*1024 bytes) of memory that DOS can address
  20977.               directly.  Any PC-AT compatible or 386 system with more than
  20978.               640K of memory has extended memory.  This memory can be used
  20979.               for a variety of purposes depending on the software installed
  20980.               to utilize it.  See also XMS.
  20981.  
  20982.               External Command:  A program which resides in an executable
  20983.               file, as opposed to an internal command which is part of the
  20984.               command processor.  For example, FORMAT and DISKCOPY are
  20985.               external commands; you can find them on your DOS disk under
  20986.               the names FORMAT.COM and DISKCOPY.COM.
  20987.  
  20988.               File Attribute:  See Attribute.
  20989.  
  20990.               File Description:  See Description.
  20991.  
  20992.               Filename Completion:  A 4DOS feature which allows you to type
  20993.               part of a filename on the command line, and have 4DOS fill in
  20994.               the rest for you.
  20995.  
  20996.               Free Memory:  Usually, the amount of base memory which is
  20997.               currently unoccupied and available for use by applications.
  20998.  
  20999.               Hidden:  A file attribute indicating that the file should not
  21000.               be displayed with a normal DIR command, and should not be
  21001.               available for access by programs unless they specifically
  21002.               request use of hidden files.
  21003.  
  21004.               History:  See Command History.
  21005.  
  21006.               History Window:  A pop-up window used by 4DOS to display the
  21007.               command history, allowing you to choose a previous command to
  21008.               modify and / or execute.
  21009.  
  21010.               Include List:  A concise method of specifying several files or
  21011.               groups of files in the same directory, for use with all 4DOS
  21012.               commands which take file names as arguments.
  21013.  
  21014.               Insert Mode:  When editing text, a mode in which newly typed
  21015.               characters are inserted into the line at the cursor position,
  21016.  
  21017.  
  21018.           ___________________________________________________________________
  21019.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  361
  21020.  
  21021.                                                                      GLOSSARY
  21022.           ___________________________________________________________________
  21023.  
  21024.  
  21025.               rather than overwriting existing characters on the line.  See
  21026.               also Overstrike Mode.
  21027.  
  21028.               Internal Command:  A command which is part of the command
  21029.               processor, as opposed to an external command.  For example,
  21030.               DIR and COPY are internal commands.
  21031.  
  21032.               Keyboard Buffer:  A buffer which holds keystrokes you have
  21033.               typed that have not yet been used by the currently executing
  21034.               program.
  21035.  
  21036.               Keystroke Alias:  An alias assigned to a key, so that it can
  21037.               be invoked or recalled with a single keystroke.
  21038.  
  21039.               Label:  A marker in a batch file.  Labels allow GOTO and GOSUB
  21040.               commands to "jump" to the command on the line following the
  21041.               label.  See also Volume Label.
  21042.  
  21043.               LF:  The ASCII character "line feed", not usually generated
  21044.               from the keyboard, but stored in most ASCII files at the end
  21045.               of each line after the CR character.
  21046.  
  21047.               Master Environment:  The master copy of the environment
  21048.               maintained by the command processor.  The master environment
  21049.               is manipulated with the SET, ESET, and UNSET commands.
  21050.  
  21051.               Memory Resident Mode:  A method of installing 4DOS in which
  21052.               swapping is disabled, and all of 4DOS remains permanently
  21053.               resident in memory.  Memory-resident mode requires much more
  21054.               memory than the normal swapping mode.
  21055.  
  21056.               Modulo:  The remainder after an integer division.  For example
  21057.               11 modulo 3 is 2, because when 11 is divided by 3 the
  21058.               remainder is 2.
  21059.  
  21060.               Multiple Commands:  A 4DOS feature which allows multiple
  21061.               commands to be placed on a line, separated by a caret (^) or
  21062.               other user-defined character.
  21063.  
  21064.               Multitasking:  A capability of some software (and the related
  21065.               hardware) which allows two or more programs to run apparently
  21066.               simultaneously on the same computer.  Multitasking software
  21067.               for PC compatible systems includes programs like DESQview.
  21068.  
  21069.               Non-Swapping Mode:  See Memory Resident Mode.
  21070.  
  21071.               Option:  See Switch.
  21072.  
  21073.  
  21074.  
  21075.           ___________________________________________________________________
  21076.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  362
  21077.  
  21078.                                                                      GLOSSARY
  21079.           ___________________________________________________________________
  21080.  
  21081.  
  21082.               OR:  A logical combination of two true or false conditions
  21083.               such that if both conditions are false the result is false; if
  21084.               either condition is true the result is true.
  21085.  
  21086.               Overstrike Mode:  When editing text, a mode in which newly
  21087.               typed characters overwrite existing characters on the line,
  21088.               rather than being inserted into the line at the cursor
  21089.               position.  See also Insert Mode.
  21090.  
  21091.               Parameter:  See Argument.
  21092.  
  21093.               Parsing:  The process 4DOS performs when it analyzes the
  21094.               command line, performs alias and environment variable
  21095.               expansion, and finds the appropriate internal command or
  21096.               external command to execute.
  21097.  
  21098.               Passed Environment:  A copy of the master environment created
  21099.               before running an application, so that any changes made by the
  21100.               application will not affect the master environment.  The size
  21101.               of the passed environment is determined by the amount of space
  21102.               actually used in the master environment when the application
  21103.               is started.
  21104.  
  21105.               Path:  A specification of the directories a file resides in,
  21106.               including all parent directories.  For example, the path for
  21107.               C:\WPFILES\MYDIR\MEMO.TXT is C:\WPFILES\MYDIR\.  Path is also
  21108.               used to refer to the environment variable PATH, which contains
  21109.               a series of path specifications used when searching for
  21110.               external commands and batch files.
  21111.  
  21112.               Pipe:  A method for collecting the standard output of one
  21113.               program and passing it on as the standard input of the next
  21114.               program to be executed, signified by a vertical bar "|" on the
  21115.               command line. See also Redirection.
  21116.  
  21117.               Primary Shell:  The copy of the command processor which is
  21118.               loaded when the system boots.
  21119.  
  21120.               RAM Disk:  A pseudo "disk drive", created by software, which
  21121.               appears like a normal physical disk drive to programs.  RAM
  21122.               disks can be stored in extended memory, XMS memory, EMS
  21123.               memory, or base memory, and provide a convenient way for
  21124.               programs to use this memory for temporary files.
  21125.  
  21126.               Read-Only:  A file attribute indicating that the file can be
  21127.               read, but not written by DOS and 4DOS.
  21128.  
  21129.  
  21130.  
  21131.  
  21132.           ___________________________________________________________________
  21133.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  363
  21134.  
  21135.                                                                      GLOSSARY
  21136.           ___________________________________________________________________
  21137.  
  21138.  
  21139.               Reboot:  The process of restarting the computer, usually by
  21140.               pressing the Ctrl, Alt, and Del keys simultaneously.
  21141.  
  21142.               Redirection:  A method for collecting the standard output of a
  21143.               program in a file, and/or of providing the standard input for
  21144.               a program from a file, signified respectively by a greater
  21145.               than symbol ">" or less than symbol "<" on the command line.
  21146.               See also Pipe.
  21147.  
  21148.               Replaceable Parameter:  See Alias Argument and Batch File
  21149.               Argument.
  21150.  
  21151.               Resident Portion:  The small portion of 4DOS stored
  21152.               permanently in memory when swapping mode is in use, as opposed
  21153.               to the larger transient portion.  The resident portion is
  21154.               stored as close as possible to the beginning of base memory.
  21155.  
  21156.               Root Directory:  The first directory, from which all other
  21157.               directories are "descended."  The root directory is referenced
  21158.               with a single backslash (\).  When a disk is first formatted,
  21159.               it is the only directory.
  21160.  
  21161.               Secondary Shell:  Any copy of any command processor which is
  21162.               loaded after the system boots.  Secondary shells may be
  21163.               started from the command line; by executing a "shell to DOS"
  21164.               operation from within an application; implicitly by executing
  21165.               some DOS-related functions within certain applications; or by
  21166.               starting a new partition in a multi-tasking or task switching
  21167.               system.
  21168.  
  21169.               Shell:  A command processor.  Also used to refer to a program
  21170.               which gives access to DOS functions and commands through a
  21171.               menu- or mouse-driven system.
  21172.  
  21173.               Source:  In the 4DOS file commands (COPY, MOVE, and RENAME),
  21174.               the original files before any copying or modification has
  21175.               taken place, i.e. those specified earlier on the command line.
  21176.               See also Target.
  21177.  
  21178.               Stack:  An area of memory used by any program to store
  21179.               temporary data while the program is running; more generally,
  21180.               any such storage area where the last item stored is normally
  21181.               the first one removed.
  21182.  
  21183.               Standard Error:  A file or character device where error
  21184.               messages from a program are displayed.  Standard error output
  21185.               always goes to the console, unless redirection is used.
  21186.  
  21187.  
  21188.  
  21189.           ___________________________________________________________________
  21190.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  364
  21191.  
  21192.                                                                      GLOSSARY
  21193.           ___________________________________________________________________
  21194.  
  21195.  
  21196.               Standard Input:  A file or character device where a program
  21197.               obtains its normal input.  Standard input always comes from
  21198.               the console, unless redirection is used.
  21199.  
  21200.               Standard Output:  A file or character device where normal
  21201.               output from a program is displayed.  Standard output always
  21202.               goes to the console, unless redirection is used.
  21203.  
  21204.               Subdirectory:  Any directory other than the root directory.
  21205.               See also Root Directory.
  21206.  
  21207.               Swap File:  A disk file created by 4DOS to store its transient
  21208.               portion when disk swapping is in use.
  21209.  
  21210.               Swapping:  A 4DOS feature which removes the larger transient
  21211.               portion of 4DOS from base memory while an application is
  21212.               running, leaving the maximum possible amount of memory for the
  21213.               application, and allows 4DOS to restore information such as
  21214.               the command history after the application is finished.  See
  21215.               also XMS Swapping, EMS Swapping, and Disk Swapping.
  21216.  
  21217.               Switch:  An argument to an internal command or application
  21218.               which specifies a particular behavior or setting.  For
  21219.               example, the command "DIR /P" might be referred to as "having
  21220.               the /P switch set".  Also, a configuration value for 4DOS
  21221.               specified on the SHELL= line in CONFIG.SYS.
  21222.  
  21223.               System:  A file attribute indicating that the file belongs to
  21224.               DOS and should not be accessed by normal programs.
  21225.  
  21226.               Target:  See Destination.
  21227.  
  21228.               Transient Portion:  The larger portion of 4DOS stored in
  21229.               memory temporarily when swapping mode is in use, as opposed to
  21230.               the smaller resident portion.  The transient portion is stored
  21231.               as close as possible to the end of base memory, and releases
  21232.               the space it is using whenever an application is executed.
  21233.  
  21234.               TSR:  A Terminate and Stay Resident program, i.e. a program
  21235.               which "terminates" but remains resident in base memory, to
  21236.               provide capabilities such as network support, a pop-up notepad
  21237.               or telephone dialer, a disk cache, or mouse support.
  21238.  
  21239.               UMB:  An XMS Upper Memory Block, whose address is above the
  21240.               end of normal base memory, but is within the 1 megabyte of
  21241.               memory that DOS can address directly.
  21242.  
  21243.  
  21244.  
  21245.  
  21246.           ___________________________________________________________________
  21247.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  365
  21248.  
  21249.                                                                      GLOSSARY
  21250.           ___________________________________________________________________
  21251.  
  21252.  
  21253.               Variable:  See Alias Argument, Batch File Argument, and
  21254.               Environment Variable.
  21255.  
  21256.               Volume Label:  A special, hidden file placed on any disk whose
  21257.               name constitutes a "label" for the entire disk.
  21258.  
  21259.               White Space Character:  Generally, a character used to
  21260.               separate arguments on the command line.  The white space
  21261.               characters recognized by 4DOS are the space, tab, comma,
  21262.               semicolon, and equal sign.
  21263.  
  21264.               Wildcard:  A character ("*" or "?") used in a filename to
  21265.               specify the possibility that any single character ("?") or
  21266.               sequence of characters ("*") can occur at that point in the
  21267.               actual name.
  21268.  
  21269.               XMS Memory:  A software method for accessing extended memory
  21270.               on 286 and 386 systems (and some systems which support version
  21271.               4.0 of the EMS memory specification).  XMS memory is not
  21272.               additional memory, but is a software specification only.  Its
  21273.               use generally requires Microsoft's HIMEM.SYS be installed as a
  21274.               device driver, or that another program such as 386MAX or MOVE-
  21275.               EM be used.
  21276.  
  21277.               XMS Swapping:  A type of swapping where the transient portion
  21278.               of 4DOS is stored in XMS memory while an application is
  21279.               running.
  21280.  
  21281.               XOR (exclusive OR):  A logical combination of two true or
  21282.               false conditions such that if both conditions are false or
  21283.               both conditions are true the result is false; if either
  21284.               condition is true and the other is false the result is true.
  21285.  
  21286.  
  21287.  
  21288.  
  21289.  
  21290.  
  21291.  
  21292.  
  21293.  
  21294.  
  21295.  
  21296.  
  21297.  
  21298.  
  21299.  
  21300.  
  21301.  
  21302.  
  21303.           ___________________________________________________________________
  21304.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  366
  21305.  
  21306.                                                                         INDEX
  21307.           ___________________________________________________________________
  21308.  
  21309.  
  21310.           INDEX                               /, in command switches, 169
  21311.  
  21312.                                               ? as file name "wildcard", 71
  21313.           Index                               ? command, 172
  21314.                                               ? internal variable, 81
  21315.                                               _? internal variable, 81
  21316.           Most fully capitalized terms
  21317.           (e.g. ECHO, SELECT) are 4DOS        @ sign, see also Variable
  21318.           command names unless otherwise       functions
  21319.           noted.                                 for key codes
  21320.                                                     in 4DOS.INI, 124
  21321.                                                     in a keystroke alias, 177
  21322.                -- Special Characters --             in KEYSTACK text, 258
  21323.                                                  in file names, 47
  21324.           ! warning mark, 2, 171                 in INKEY results, 253
  21325.                                                  to define a keystroke alias,
  21326.           ## advanced topic mark, 2, 54,          176
  21327.            170                                   to override batch file echo,
  21328.                                                   100, 222, 289
  21329.           % sign                                 to override command history
  21330.              in file names, 47                    save, 57
  21331.              use with environment                to read a file in FOR, 230
  21332.               variables, 78, 79
  21333.              use with replaceable             || (or) in conditional
  21334.               parameters, 95, 100, 179         commands, 92
  21335.              use with variable functions,
  21336.               85
  21337.           %# and %n&                               -- 4 --
  21338.              changing parameter
  21339.               character, 132, 307             4DOS
  21340.              in aliases, 179                     and DESQview, see DESQview
  21341.              in batch files, 101, 310            and DOS versions, 114, 153
  21342.           %0 to %127                             and DR-DOS, 9, 50, 111, 113,
  21343.              in aliases, 179                      139, 153
  21344.              in batch files, 100, 310            and MS-DOS 5.0, 64, 113
  21345.                                                  and MS-DOS 5.0 memory
  21346.           && (and) in conditional                 management, 50, 144, 145,
  21347.            commands, 91                           261
  21348.                                                  and MS-DOS 6.0, 111, 113,
  21349.           * (asterisk)                            212, 214, 263, 298, 300
  21350.              as file name "wildcard", 71         and other software, 153
  21351.              in alias name, 176                  and Windows, see Microsoft
  21352.              in alias value, 174                  Windows
  21353.              to temporarily disable an           configuration, 80, 109, 119
  21354.               alias, 62, 105, 175                detecting, 348
  21355.                                                  Features, 9
  21356.           ., see Current directory               memory usage, 126, 128, 140
  21357.           .., see Parent directory               programming interface, 348
  21358.  
  21359.  
  21360.           ___________________________________________________________________
  21361.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  367
  21362.  
  21363.                                                                         Index
  21364.           ___________________________________________________________________
  21365.  
  21366.  
  21367.           4DOS (continued)                         -- A --
  21368.              resident portion, 126
  21369.                 loading in high memory,       Abort, Retry, Fail message, see
  21370.                  128                           Critical errors
  21371.              startup options, see Startup     AddFile directive, 136
  21372.               options                         Advanced topic mark, see v
  21373.              transient portion, 126, 140      ALIAS command, 166, 173
  21374.           4DOS Utility Disk, 242              Alias directive, 125
  21375.           4DOS.COM, 113, 116                  _ALIAS internal variable, 82
  21376.           4DOS.INI, 109, 119                  Aliases, 96, 173
  21377.              advanced directives, 138            and CANCEL, 188
  21378.              and installation, 119               and QUIT, 285
  21379.              and SETDOS, 121, 129, 305           asterisk in name, 176
  21380.              color directives, 132               asterisk in value, 174
  21381.              comments in, 120                    back quotes in, 96, 173,
  21382.              configuration directives,            174, 179
  21383.               129                                commands for, 167
  21384.              directive types, 123                defining default command
  21385.              directives, 120, see also            options with, 175, 180
  21386.               names of individual                editing, 226
  21387.               directives                         examples, 96, 103, 106
  21388.              errors in, 121, 126                 IFF in, 180
  21389.              initialization directives,          in batch files, 103
  21390.               125                                inheritance in secondary
  21391.              key mapping directives, 133          shells, 140, 180
  21392.              location of, 111, 113, 114          internal variables in, 180
  21393.                 and multitaskers, 122            keystroke, 98, 176
  21394.              primary section, 121                   and key assignments, 134
  21395.                 in alternate files, 122             automatic execution of,
  21396.              secondary section, 121                  94, 98, 178
  21397.                 and DESQview, 159                memory space for, 82, 125,
  21398.                 and multitaskers, 154             271
  21399.                 example, 142                     multiple commands in, 173
  21400.           4DOS.PIF, 157                          nesting, 174
  21401.           4EXIT, 43, 109, 118                    order of execution, 44
  21402.              location of, 118, 125               reading from a file, 181
  21403.           4OS2 product, 1                        removing, 319
  21404.           4START, 43, 85, 109, 118               replaceable parameters in,
  21405.              and multitaskers, 155                179, 180
  21406.              and startup command, 113            saving in a file, 178
  21407.              and TSRs, 118                       saving temporarily, 225, 309
  21408.              location of, 118, 125               suspending execution of, 278
  21409.           4StartPath directive, 125              temporarily disabling, 62,
  21410.           _4VER internal variable, 82             105, 175
  21411.                                                  variable functions in, 90,
  21412.                                                   180
  21413.                                               Alt-255, 55
  21414.  
  21415.  
  21416.  
  21417.           ___________________________________________________________________
  21418.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  368
  21419.  
  21420.                                                                         Index
  21421.           ___________________________________________________________________
  21422.  
  21423.  
  21424.           And (&&) in conditional             AUTOEXEC.BAT (continued)
  21425.            commands, 91                          starting KSTACK.COM, 15, 68,
  21426.           .AND., in IF and IFF, 245, 250,         116, 257
  21427.            251                                AutoExecPath directive, 111,
  21428.           ANSI directive, 129, 148, 195,       112, 125
  21429.            196, 306                           Automatic batch files, 43
  21430.           ANSI driver, 53                     Automatic directory changes,
  21431.              and CLS, 194, 306                 61, 117
  21432.              and COLOR, 196, 306
  21433.              and COLORDIR, 211
  21434.              and colors, 133                       -- B --
  21435.              and cursor problems, 147
  21436.              and DESQview, 158                Back & Forth, 114, 122
  21437.              and PROMPT, 281                  Backspace character, 94
  21438.              and scrolling, 147, 307          Backspace directive, 134
  21439.              and TEXT, 313                    Base memory, see Memory
  21440.              detecting, 82, 148               Base name, see File names
  21441.              escape sequences, 94, 281,       .BAT files, 99, 266
  21442.               313                             Batch files, 99
  21443.              in CONFIG.SYS, 148                  aliases in, 103, 105
  21444.              use by 4DOS, 129, 146               based on command history,
  21445.           _ANSI internal variable, 82             243
  21446.           ANSI.COM, 148                          branching in, 239
  21447.           ANSI.SYS, 148                          calling, 186
  21448.           APPEND command, 153                    capturing output of, 106
  21449.           Appending files, 197                   chaining, 108, 186
  21450.           Archive attribute, see File            commands for, 102, 167
  21451.            attributes                            comments in, 289
  21452.           Argument quoting, 95                   debugging, 106
  21453.           Arguments, see replaceable             displaying messages in, 222,
  21454.            parameters                             224, 293, 294, 313, 325
  21455.           Arithmetic, 87                         echoing of commands, 100,
  21456.           ASCII, 51, 338                          129, 222, 308
  21457.           @ASCII variable function, 86           environment variables in,
  21458.           Asterisk, see *                         101
  21459.           At sign, see @ sign                    internal variables in, 84,
  21460.           ATTRIB, 182                             101
  21461.           @ATTRIB variable function, 86          keyboard input in, 253, 256
  21462.           Attributes, see File attributes        labels in, 237, 239
  21463.           AUTOEXEC.BAT, 43, 109, 115             modes, 99, 266
  21464.              and 4START, 118                     nesting, 82, 186
  21465.              and startup command, 113            order of execution, 44
  21466.              disabling, 111                      replaceable parameters, 100,
  21467.              location of, 125                     310
  21468.              running, 112                        saving environment in, 225,
  21469.              setting COMSPEC in, 111              309
  21470.              speeding up, 311                    screen display, 218, 220,
  21471.                                                   221
  21472.  
  21473.  
  21474.           ___________________________________________________________________
  21475.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  369
  21476.  
  21477.                                                                         Index
  21478.           ___________________________________________________________________
  21479.  
  21480.  
  21481.           Batch files (continued)
  21482.              subroutines, 237, 292            CMDLINE environment variable,
  21483.              suspending execution of, 278      80
  21484.              temporary variables in, 101      Code page, 82, 193
  21485.              terminating, 188, 285            _CODEPAGE internal variable, 82
  21486.              timing events in, 315            Cold reboot, 287
  21487.              tips, 103                        COLOR, 102, 196
  21488.              variable functions in, 91,          and DESQview, 158
  21489.               101                             ColorDir directive, 132
  21490.           _BATCH internal variable, 82        COLORDIR environment variable,
  21491.           BatchEcho directive, 100, 129,       80, 117, 211, 298
  21492.            308                                   and DESQview, 158
  21493.           BEEP, 102, 129, 184                    and redirection, 212
  21494.           BeepFreq directive, 129             Colors, see Screen; Monochrome
  21495.           BeepLength directive, 129            monitor
  21496.           BeginLine directive, 134            _COLUMN internal variable, 82
  21497.           _BG internal variable, 82           _COLUMNS internal variable, 82
  21498.           Boxes, drawing, 218                 Command grouping, 92, see also
  21499.           BREAK, 185                           EXCEPT, FOR, GLOBAL, and IF
  21500.           BrightBG directive, 129, 148        Command history, see History
  21501.           .BTM files, 99, 266                  list
  21502.                                               Command interpreter, 41
  21503.                                               Command line, 54
  21504.                -- C --                           arguments, see replaceable
  21505.                                                   parameters
  21506.           CALL, 102, 108, 186                    automatic directory changes,
  21507.           CANCEL, 102, 186, 188, 285              61
  21508.           Carriage return character, 94          echoing of, 222, 223
  21509.           Case (upper / lower), 132, 308         editing, 55, 134, 136
  21510.           CD, 189                                editing mode, 55, 130, 307
  21511.           CD-ROM drives, 149                     expanded, 223
  21512.           CDD, 191                               filename completion, 59
  21513.           CDPATH environment variable,           help, 63
  21514.            80, 117                               history, 56, see also
  21515.              and automatic directory              History list
  21516.               changes, 62                        history window, 58
  21517.              and CD, 190                         input method, 131, 307
  21518.              and CDD, 191                        multiple commands, 61
  21519.              and PUSHD, 284                      processing of, 43
  21520.           ChangeTitle directive, 138             prompt, 280
  21521.           Changing directories, 61, 189,      Command processing, 43
  21522.            191, 279, 283                      Command Reference Guide, 166
  21523.           @CHAR variable function, 86         Command tail, 43, 45
  21524.           CHCP, 193, 204, 213, 314            Command, 4DOS startup, 113, 115
  21525.           CHDIR, 189                             and multitaskers, 155
  21526.           ClearKeyMap directive, 134, 138     COMMAND.COM
  21527.           CLS, 102, 194                          in DOS version 2.x, 114
  21528.              and DESQview, 158                   in Microsoft Windows, 156
  21529.  
  21530.  
  21531.           ___________________________________________________________________
  21532.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  370
  21533.  
  21534.                                                                         Index
  21535.           ___________________________________________________________________
  21536.  
  21537.  
  21538.           COMMAND.COM (continued)             CONFIG.SYS (continued)
  21539.              in multitasker DOS windows,         and DOS bug, 113
  21540.               154                             Configuration, 4DOS, 80, 109,
  21541.              message server, 140               119
  21542.           CommandEscape directive, 136        CONsole device, 203, 312, see
  21543.           Commands                             also Standard input, Standard
  21544.              conditional execution of,         output, and Standard error
  21545.               251                             Coprocessor, see Numeric
  21546.              external, 44, 166, 168, 276       coprocessor
  21547.              format of, 168                   COPY, 197
  21548.              help for, 63, 241                   and extended attributes, 200
  21549.              internal, 44, 166                CopyEA directive, 138, 200, 274
  21550.                 disabling, 172, 306           Country code, 204, 213, 282,
  21551.              list of, 167, 172                 314
  21552.              new, 168                         CPU, 49, 143
  21553.              order of execution, 44, 77       _CPU internal variable, 82
  21554.              programming interface, 350       CritFail directive, 138, 152
  21555.              types of, 167, 168               Critical errors, 151
  21556.           CommandSep directive, 130, 306         automatic Fail response,
  21557.           Comments                                112, 114, 138
  21558.              in 4DOS.INI, 120                 Ctrl-Break
  21559.              in alias files, 181                 checking, 185
  21560.              in AUTOEXEC.BAT, 164                during DELAY, 207
  21561.              in batch files, 289                 during INKEY, 253
  21562.              in CONFIG.SYS, 15, 16, 17,          during PAUSE, 278
  21563.               164                                during SELECT, 297
  21564.              in environment variable          Ctrl-C, see Ctrl-Break
  21565.               files, 304                      Ctrl-X, see Escape character
  21566.           Compatibility, 9, 11                Ctrl-Z, 201
  21567.              with hardware, 143               CTTY, 67, 203
  21568.              with other software, 153,        Current drive and directory, 47
  21569.               161                                changing, see Changing
  21570.           Compound character, 306                 directories
  21571.           COMSPEC environment variable,          retrieving, 82
  21572.            80, 116                               saving temporarily, 225,
  21573.              and disk swapping, 128               279, 283, 309
  21574.              and DOS FORMAT /S, 153           Cursor
  21575.              and LOG file location, 268          positioning, 293, 294, 325
  21576.              and multitaskers, 154               shape, 130, 147, 308
  21577.              checking, 111                    CursorIns directive, 130, 147,
  21578.              on laptop and notebook            308
  21579.               computers, 151                  CursorOver directive, 130, 147,
  21580.              removing, 320                     308
  21581.              setting automatically, 111       _CWD internal variable, 82
  21582.           Conditional commands, 91            _CWDS internal variable, 83
  21583.           CONFIG.SYS, 41, 109                 _CWP internal variable, 83
  21584.              4DOS commands in, 110            _CWPS internal variable, 83
  21585.              and ANSI driver, 148
  21586.  
  21587.  
  21588.           ___________________________________________________________________
  21589.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  371
  21590.  
  21591.                                                                         Index
  21592.           ___________________________________________________________________
  21593.  
  21594.  
  21595.                -- D --                        Disk drives (continued)
  21596.                                                  space on, 87, 234
  21597.           Daily execution of batch file,         swapping to, 127, 311
  21598.            91                                    testing status of, 89
  21599.           DATE, 204                              volume label, 88, 324
  21600.           _DATE internal variable, 83            write verification on, 323
  21601.           @DATE variable function, 86         _DISK internal variable, 83
  21602.           Day of week, 83                     @DISKFREE variable function, 87
  21603.           DBLSPACE, see File compression         on networks, 160
  21604.           Default directory, see Current      Diskless workstations, 160
  21605.            drive and directory                DiskReset directive, 139, 149
  21606.           Default drive, see Current          @DISKTOTAL variable function,
  21607.            drive and directory                 87
  21608.           DEL, 149, 205                          on networks, 160
  21609.           Del directive, 135                  @DISKUSED variable function, 87
  21610.           DELAY, 207                             on networks, 160
  21611.           Deleting files, 205                 Display colors, see Screen;
  21612.           DelHistory directive, 136            Video
  21613.           DelToBeginning directive, 135       DOS, 153
  21614.           DelToEnd directive, 135                APPEND command, 153
  21615.           DelWordLeft directive, 135             bug in CONFIG.SYS
  21616.           DelWordRight directive, 135             processing, 113
  21617.           DESCRIBE, 134, 208                     command interpreter, 42
  21618.           @DESCRIPT variable function, 86        commands, help for, 63, 168,
  21619.           DESCRIPT.ION, 208, see File             241
  21620.            descriptions                          compatibility box, see OS/2
  21621.           DescriptionMax directive, 130,         external commands, 166
  21622.            208                                   FORMAT /S command, 153
  21623.           Descriptions, see File                 hidden files, 41
  21624.            descriptions                          memory, see Memory
  21625.           DESQview, 139, 157                     shell (defined), 1
  21626.              and secondary shells, 114,          structure, 41
  21627.               122                                version 2.x, 110, 114
  21628.              detecting, 83, 85                _DOS internal variable, 83
  21629.           Detecting 4DOS, 348                 @DOSMEM variable function, 87
  21630.           DIR, 149, 210                       _DOSVER internal variable, 83
  21631.              and include lists, 75            _DOW internal variable, 83
  21632.              directory size limits, 213       Down directive, 135
  21633.           Directories, see Subdirectories     DR-DOS, see 4DOS and DR-DOS
  21634.           Directory stack, 283                DRAWBOX, 102, 146, 218
  21635.              clearing, 279                    DRAWHLINE, 102, 146, 220
  21636.              displaying, 217                  DRAWVLINE, 102, 146, 221
  21637.              size, 283                        Drive, see Disk drives
  21638.           DIREXIST test, in IF and IFF,       Drive letter, 46
  21639.            249                                DRSets directive, 139
  21640.           DIRS, 217, 279, 283                 _DV internal variable, 83
  21641.           Disk drives, 148                    DVCleanup directive, 139, 159
  21642.              drive letter, 46
  21643.  
  21644.  
  21645.           ___________________________________________________________________
  21646.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  372
  21647.  
  21648.                                                                         Index
  21649.           ___________________________________________________________________
  21650.  
  21651.  
  21652.                -- E --                        Environment variables (cont'd)
  21653.                                                  referencing, 78
  21654.           ECHO, 222                              removing, 320
  21655.              ANSI sequences in, 94               spaces in, 303
  21656.              at command line, 223             ERASE, 149, 205
  21657.              in batch files, 100, 102,        EraseLine directive, 135
  21658.               106, 289                        Error level, see Exit code
  21659.                 default state, 129, 308       Error messages, 327
  21660.                 inheritance, 186              ERRORLEVEL test, in IF and IFF,
  21661.           ECHOS, 102, 224                      248
  21662.           Editing aliases and environment     Escape character, 94, 130, 306
  21663.            variables, 226                     EscapeChar directive, 130, 306
  21664.           EditMode directive, 130, 307        ESET, 134, 226
  21665.           EGA, 146, 148, 193, 250                and environment variables,
  21666.           ELSE, in IFF, 251                       78, 303
  21667.           ELSEIFF, in IFF, 251                   and PATH, 162, 276
  21668.           EMS, see Memory                     @EVAL variable function, 87
  21669.           @EMS variable function, 87          EXCEPT, 92, 141, 227
  21670.           EndHistory directive, 136              and DEL /Z, 206
  21671.           ENDIFF, in IFF, 251                 @EXEC variable function, 87
  21672.           EndLine directive, 135              ExecLine directive, 135
  21673.           ENDLOCAL, 101, 105, 225, 309,       Executable extensions, 44, 76
  21674.            320                                   wildcards in, 77
  21675.           ENDTEXT, 103, 313                   EXIST test, in IF and IFF, 249
  21676.           _ENV internal variable, 83          EXIT, 118, 229
  21677.           EnvFree directive, 126, 303         Exit code, 81, 229, 285
  21678.           Environment, 48, 78, 302               and CALL, 187
  21679.              loading in high memory, 128         and GLOBAL, 236
  21680.              master, 226, 303, 320               and IF tests, 248
  21681.              memory space for                 Expanded memory, see Memory
  21682.                 displaying, 271               @EXT variable function, 87
  21683.                 setting, 111, 114, 126        Extended attributes
  21684.                 testing, 83                      and COPY, 200
  21685.              saving temporarily, 225, 309        and MOVE, 273
  21686.              size, and compatibility          Extended key codes, see Key
  21687.               problems, 163                    codes
  21688.           Environment directive, 126, 303     Extended memory, see Memory
  21689.           Environment variables, 48, 78,      @EXTENDED variable function, 87
  21690.            302                                Extension, see File names
  21691.              and INKEY, 253                   External commands, see Commands
  21692.              and INPUT, 256
  21693.              characters in name, 78
  21694.              creating, 302                         -- F --
  21695.              displaying, 302
  21696.              editing, 226                     _FG internal variable, 83
  21697.              expansion, 95                    File attributes, 47, 182
  21698.              nesting, 78                         and COPY, 200, 201
  21699.              reading from a file, 303            and DEL, 206
  21700.  
  21701.  
  21702.           ___________________________________________________________________
  21703.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  373
  21704.  
  21705.                                                                         Index
  21706.           ___________________________________________________________________
  21707.  
  21708.  
  21709.           File attributes (continued)
  21710.              and DIR, 210, 213, 216, 233      FOR, 92, 102, 141, 230
  21711.              and EXCEPT, 227                     and GOSUB, 232
  21712.              and GLOBAL, 235                  Form feed character, 94
  21713.              and MOVE, 272, 274               FORMAT /S command, 153
  21714.              and REN, 291                     FREE, 234
  21715.              and SELECT, 299                     on networks, 160
  21716.              setting, 182                     Free disk space, see disk space
  21717.              subdirectory, 183                Free memory, see Memory
  21718.              testing, 86                      @FULL variable function, 88
  21719.              viewing, 182                     FullINT2E directive, 139
  21720.              volume label, 183
  21721.           File compression, 212, 214,
  21722.            298, 300                                -- G --
  21723.           File descriptions, 208
  21724.              and disk performance, 149        General Concepts, 41
  21725.              length of, 130, 208, 212,        GLOBAL, 92, 141, 235
  21726.               299                             Glossary, 355
  21727.              programming for, 351             GOSUB, 102, 108, 237, 292
  21728.              retrieving, 86                      and FOR, 232
  21729.              sorting by, 215, 301             GOTO, 102, 239
  21730.           File names, 45                         and IFF, 107, 252
  21731.              parts of, 45                     Guided Tour, 18
  21732.                 separating, 87, 88, 89
  21733.              shorthand for, 70
  21734.              unique, 90                            -- H --
  21735.           @FILEDATE variable function, 87
  21736.           Filename completion, 59             Hard drives, 148
  21737.           Files, 45                           Hardware compatibility, see
  21738.              adding line numbers to, 318       Compatibility
  21739.              copying, 197                     HELP, 63, 241
  21740.              date, 48, 87, 204, 210              and external commands, 168
  21741.              deleting, 205                       and mouse, 64
  21742.              displaying, 264, 318                location of files, 126
  21743.              moving, 272, 290                    on monochrome screen, 151,
  21744.              reading, in FOR, 230                 242
  21745.              renaming, 290                       options, 126, 151, 242
  21746.              retrieving lines from, 88        Help directive, 136
  21747.              searching for, 89                HELPCFG program, 151, 241
  21748.              selecting, 296                   HelpOptions directive, 126, 151
  21749.              size of, 87, 210                 HelpPath directive, 126, 241
  21750.              time stamp, 48, 88, 314          Hidden attribute, see File
  21751.              true path of, 90, 317             attributes
  21752.           @FILESIZE variable function, 87     HistMin directive, 131
  21753.           @FILETIME variable function, 88     HISTORY, 118, 243
  21754.           FineSwap directive, 139             History directive, 126
  21755.           Floppy disks, 148, 149              History list, 56, 243
  21756.                                                  controlling, 131, 244
  21757.  
  21758.  
  21759.           ___________________________________________________________________
  21760.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  374
  21761.  
  21762.                                                                         Index
  21763.           ___________________________________________________________________
  21764.  
  21765.  
  21766.           History list (continued)
  21767.              inheritance in secondary         ISALIAS test, in IF and IFF,
  21768.               shells, 140                      249
  21769.              memory space for, 126, 271       ISDIR test, in IF and IFF, 249
  21770.              reading from a file, 244         ISINTERNAL test, in IF and IFF,
  21771.           History window, 58, 132              249
  21772.           HistWinBegin directive, 137
  21773.           HistWinColor directive, 132
  21774.           HistWinDel directive, 137                -- J --
  21775.           HistWinEdit directive, 137
  21776.           HistWinEnd directive, 137           JOIN command, 317
  21777.           HistWinExec directive, 137
  21778.           HistWinHeight directive, 131
  21779.           HistWinLeft directive, 131               -- K --
  21780.           HistWinOpen directive, 137
  21781.           HistWinTop directive, 131           Key
  21782.           HistWinWidth directive, 131            codes, 51, 338, 342
  21783.           HMA, see Memory                        mapping, 133
  21784.                                                     clearing default key map,
  21785.                                                      138
  21786.                -- I --                              for all input, 134
  21787.                                                     for command line editing,
  21788.           IF, 92, 102, 141, 245                      136
  21789.              conditions, 246                        for history window, 137
  21790.           IFF, 102, 251                             for LIST, 137
  21791.              and GOSUB, 237                      names, 124, 176, 254, 258
  21792.              and GOTO, 107, 252               Keyboard, 51
  21793.              conditions, 246                  KEYSTACK, 68, 103, 107, 257
  21794.           Include lists, 74                      programming interface, 349
  21795.           @INDEX variable function, 88        Keystroke aliases, see Aliases
  21796.           Inherit directive, 140              KSTACK.COM, 15, 68, 116, 257
  21797.           INKEY, 103, 106, 253
  21798.           INPUT, 103, 134, 256
  21799.           Ins directive, 135                       -- L --
  21800.           Installable commands, 350
  21801.           Installation, 13                    @LABEL variable function, 88
  21802.              manual, 14                       Labels, in batch files, 237,
  21803.              reversing, 15                     239
  21804.              with monochrome monitor, 14      Laptop computers, 150
  21805.           INT 2E, 353                         Left directive, 135
  21806.           INT 2F, 348                         @LEN variable function, 88
  21807.           @INT variable function, 88          LH, 144, 145, 261
  21808.           Internal commands, see Commands     LIM EMS, see Memory
  21809.           Internal variables, 81, see         Line feed character, 94
  21810.            also names of individual           @LINE variable function, 88
  21811.            variables                          LineInput directive, 131, 307
  21812.              in aliases, 180                  Lines, drawing, on screen, 220,
  21813.              in batch files, 84, 101           221
  21814.  
  21815.  
  21816.           ___________________________________________________________________
  21817.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  375
  21818.  
  21819.                                                                         Index
  21820.           ___________________________________________________________________
  21821.  
  21822.  
  21823.           LIST, 264                           Memory (continued)
  21824.              default colors, 133                 high memory area (HMA), 50,
  21825.              keys used with, 134, 137             145
  21826.              output method, 146                     DOS in, 322
  21827.              screen size, 132, 147, 307             status of, 271
  21828.           ListColors directive, 133              problems with, 146
  21829.           ListFind directive, 137                upper, 49
  21830.           ListHighBit directive, 138             upper memory blocks (UMBs),
  21831.           ListNext directive, 138                 50
  21832.           ListPrint directive, 138                  4DOS's use of, 128, 144
  21833.           ListWrap directive, 138                   and LOADHIGH, 261
  21834.           Literal keystrokes, 55                    regions in, 261
  21835.           LOADBTM, 100, 103, 266              Memory resident programs, see
  21836.           LOADHIGH, 144, 145, 261              TSRs
  21837.           LOG, 106, 118, 268                  Messages, displaying, 222, 224
  21838.           Log file location, 268              MessageServer directive, 140
  21839.           LogName directive, 126              Microsoft Windows, 155, 156
  21840.           Lower case, 132, 308                   and secondary shells, 114,
  21841.           @LOWER variable function, 88            122
  21842.           @LPT variable function, 88             detecting, 84, 157
  21843.                                               MKDIR, 270
  21844.                                               _MONITOR internal variable, 83
  21845.                -- M --                        Monochrome monitor
  21846.                                                  and HELP, 151, 242
  21847.           Master environment, see                and installation, 14
  21848.            Environment                           and Microsoft Windows, 157
  21849.           MD, 270                             Mouse, in HELP, 64
  21850.           MEMORY, 145, 163, 271               MOVE, 272
  21851.              and QEMM, 145                       and extended attributes, 273
  21852.           Memory, 49, 144                        and SELECT, 273
  21853.              base, 49                         MS-DOS, see 4DOS and MS-DOS
  21854.                 4DOS's use of, 144            Multiple commands, 61
  21855.                 amount of, 87                    in aliases, 173
  21856.                 DOS in, 322                      separator character, 61, 95,
  21857.              expanded (EMS), 49, 50               130, 306
  21858.                 4DOS's use of, 144            Multiple filenames, 74
  21859.                 amount of, 87, 271            Multitasking software, 154
  21860.                 hardware, 145                    and disk swapping, 155
  21861.                 swapping to, 126, 146,           DESQview, 157
  21862.                  311                             Microsoft Windows, 156
  21863.              extended, 49, 50
  21864.                 4DOS's use of, 145
  21865.                 amount of, 87, 271                 -- N --
  21866.              extended (XMS), 50
  21867.                 4DOS's use of, 144, 145       @NAME variable function, 89
  21868.                 amount of, 90, 271            _NDP internal variable, 83
  21869.                 swapping to, 126, 311         NetwareNames directive, 140
  21870.              free, 271
  21871.  
  21872.  
  21873.           ___________________________________________________________________
  21874.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  376
  21875.  
  21876.                                                                         Index
  21877.           ___________________________________________________________________
  21878.  
  21879.  
  21880.           Networks, 159                            -- P --
  21881.              and pipes, 160
  21882.              disk access problems on, 149     ParameterChar directive, 132,
  21883.              disk space calculations on,       307
  21884.               160                             Parent directory, 47, 71, 189,
  21885.              disk swapping on, 141, 160        191, 270
  21886.              drive names on, 46               Parsing, 45
  21887.              file and directory names on,     PATH command, 162, 276
  21888.               159                             PATH environment variable, 49,
  21889.           NextFile directive, 136              80, 116
  21890.           NextHistory directive, 136             "." in, 277
  21891.           NextINIFile directive, 140             and @SEARCH variable
  21892.           NoClobber directive, 132, 307           function, 89
  21893.           NormalEditKey directive, 136           avoiding search of, 35
  21894.           NormalHWinKey directive, 137           changing, 226, 276
  21895.           NormalKey directive, 134, 135          format of, 276
  21896.              and keystroke aliases, 177          invalid directory in, 277
  21897.           NormalListKey directive, 138           length of, 162, 277
  21898.           NOT, in IF and IFF, 245, 250,          searching path, 44
  21899.            251                                   viewing, 276
  21900.           Notebook computers, 150             @PATH variable function, 89
  21901.           Novell Netware, 140, 141, 159       Path, of a file, 45, 47
  21902.           Numeric coprocessor, 83, 143           and aliases, 98
  21903.           Numeric tests, in IF and IFF,          extracting from full file
  21904.            248                                    name, 89
  21905.                                                  finding full path name, 88
  21906.                                                  finding true path, 90, 317
  21907.                -- O --                           if omitted, 47
  21908.                                                  in executable extensions, 76
  21909.           Operating system, detecting            in include lists, 75
  21910.            type of, 83                        PAUSE, 103, 106, 278
  21911.           Options                             PauseOnError directive, 121,
  21912.              in commands, 169                  126
  21913.              startup, see Startup Options     Percent sign, see % sign
  21914.           Or (||) in conditional              Pipes, 67, 312
  21915.            commands, 92                          and networks, 160
  21916.           .OR., in IF and IFF, 245, 250,      POPD, 217, 279, 283
  21917.            251                                PrevFile directive, 137
  21918.           OS/2                                PrevHistory directive, 137
  21919.              4OS2 product, 1                  [Primary], see 4DOS.INI
  21920.              command grouping, 92             Primary shell, see Shell
  21921.              detecting, 83                    Printer
  21922.              DOS sessions, 9, 83, 141            checking status of, 88
  21923.                 extended attributes and,         sending control codes to, 95
  21924.                  138, 200, 273                   sending files to, 197
  21925.                 in OS/2 version 2.x, 42,      Programming for 4DOS, see
  21926.                  112, 229                      Technical Information
  21927.                titles in, 138
  21928.  
  21929.  
  21930.           ___________________________________________________________________
  21931.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  377
  21932.  
  21933.                                                                         Index
  21934.           ___________________________________________________________________
  21935.  
  21936.  
  21937.           PROMPT command, 118, 155, 280       @REMOVABLE variable function,
  21938.              ANSI sequences in, 94, 281        89
  21939.              changing for secondary           REN, 272, 290
  21940.               shell, 85                       RENAME, 272, 290
  21941.              environment variables and        Replaceable parameters
  21942.               functions in, 79, 85, 281          in aliases, 179, 180
  21943.           PROMPT environment variable,           in batch files, 100, 310
  21944.            81, 117                            ReserveTPA directive, 140
  21945.           Prompt Solution, The, 5             RETURN, 102, 237, 292
  21946.           PUSHD, 217, 279, 283                Right directive, 136
  21947.                                               RMDIR, 286
  21948.                                               ROM, booting from, 150
  21949.                -- Q --                        Root directory, 46
  21950.                                               _ROW internal variable, 84
  21951.           QUIT, 103, 186, 188, 285            _ROWS internal variable, 84
  21952.           Quoting, of arguments, 95
  21953.  
  21954.                                                    -- S --
  21955.                -- R --
  21956.                                               SaveHistory directive, 137
  21957.           RAM, see Memory                     Scan codes, see Key codes
  21958.           RAM disk, 46, 145                   SCREEN, 103, 293
  21959.              swapping to, 126                 Screen, see also Video
  21960.           RD, 286                                clearing, 194
  21961.           Read-only attribute, see File          colors, see also Monochrome
  21962.            attributes                             monitor
  21963.           @READY variable function, 89              and ANSI driver, 53, 133,
  21964.           REBOOT, 287                                306
  21965.           Redirection, 66                           and cursor, 147
  21966.              alternative methods, 312,              bright backgrounds, 129,
  21967.               326                                    148
  21968.              and COLORDIR environment               in DIR, 211
  21969.               variable, 212                         in HELP, 151, 241
  21970.              and command grouping, 93               in history window, 132
  21971.              and NoClobber, 67, 307                 in LIST, 133, 265
  21972.              capturing batch file output,           in PROMPT, 281
  21973.               106                                   in SELECT, 133, 298
  21974.              nested, 67                             of boxes, 218
  21975.              preventing file overwrites,            of lines, 220, 221
  21976.               132                                   of text, 294, 313, 325
  21977.           Reduce directive, 140                     setting defaults, 132,
  21978.           Registration, 5                            194, 196, 306
  21979.           REM, 103, 164, 289                        setting, in 4START, 85,
  21980.              in AUTOEXEC.BAT, 16, 164                118
  21981.              in CONFIG.SYS, 15, 16, 17,             testing, 82, 83
  21982.               164                                size, 52, 82, 84, 132, 146,
  21983.           @REMOTE variable function, 89           307
  21984.  
  21985.  
  21986.  
  21987.           ___________________________________________________________________
  21988.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  378
  21989.  
  21990.                                                                         Index
  21991.           ___________________________________________________________________
  21992.  
  21993.  
  21994.           ScreenRows directive, 132, 147,     Shell (continued)
  21995.            307                                   secondary, 42
  21996.           SCRPUT, 103, 146, 294                     and COMSPEC, 116
  21997.           Search path, see PATH                     and multitaskers, 154
  21998.            environment variable                     exiting from, 229
  21999.           @SEARCH variable function, 89             inheritance, 121, 140,
  22000.           [Secondary], see 4DOS.INI                  180, 305
  22001.           Secondary shell, see Shell                startup options, 114
  22002.           SELECT, 296                            visual shell, 42
  22003.              and command grouping, 93         _SHELL internal variable, 84
  22004.              and include lists, 75            SHELL= line, in CONFIG.SYS, 15,
  22005.              and MOVE, 273                     42, 110, 151
  22006.              and stack size, 141                 and DOS version 2.x, 114
  22007.              default colors, 133              SHIFT, 101, 103, 310
  22008.              keys used with, 134              Software compatibility, see
  22009.              output method, 146                Compatibility
  22010.              screen size, 132, 147, 307       Sound, see BEEP
  22011.           Serial port, 203                    StackSize directive, 141
  22012.           SET, 78, 302                        Standard error device, 65, 66
  22013.           SETDOS, 305                         Standard input device, 65, 66,
  22014.              /A(NSI), 129, 148, 195, 196,      265, 312, 326
  22015.               306                             Standard output device, 65, 66,
  22016.              /C(ompound character), 130,       312, 326
  22017.               306                             Startup options, 110
  22018.              /E(scape character), 94,            //iniline, 112, 114, 155
  22019.               130, 306                           @d:\path\inifile, 111, 114,
  22020.              /I(nternal), 172, 249, 306           154
  22021.              /L(ine), 131, 307                   commands in, 113, 115
  22022.              /M(ode), 130, 307                   for secondary shells, 114
  22023.              /N(o clobber), 132, 307          StdColors directive, 133
  22024.              /P(arameter character), 132,     Stopwatch, see TIMER
  22025.               307                             String tests, in IF and IFF,
  22026.              /R(ows), 132, 147, 307            246
  22027.              /S(hape), 130, 147, 308          Subdirectories, 46
  22028.              /U(pper), 84, 132, 215, 308         attributes of, 182
  22029.              /V(erbose), 100, 129, 308           changing, see Changing
  22030.              and 4DOS.INI, 121, 305               directories
  22031.           SETLOCAL, 101, 103, 105, 309,          copying, 201
  22032.            320                                   creating, 270
  22033.           Shell                                  deleting files from, 206
  22034.              DOS shell (defined), 1              descriptions for, 208
  22035.              level, 84, 282                      executing commands in, 235
  22036.              primary, 42                         hidden, 235
  22037.                 and multitaskers, 154,           moving, 272, 274
  22038.                  155                             name, maximum length of, 47
  22039.                 startup options, 110             removing, 206, 274, 286
  22040.                                                  renaming, 290
  22041.                                                  testing for, 249
  22042.  
  22043.  
  22044.           ___________________________________________________________________
  22045.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  379
  22046.  
  22047.                                                                         Index
  22048.           ___________________________________________________________________
  22049.  
  22050.  
  22051.           Subdirectory attribute, see         _TIME internal variable, 84
  22052.            File attributes                    @TIME variable function, 90
  22053.           SUBST command, 317                  TIMER, 103, 315
  22054.           @SUBSTR variable function, 89       Tour, of 4DOS features, 18
  22055.           Swapping, 126                       TRUENAME, 317
  22056.              and compatibility, 146           @TRUENAME variable function,
  22057.              and multitasking software,        90, 317
  22058.               156                             TSRs, 153
  22059.              enabling and disabling, 311         and .BTM files, 266
  22060.              file names used by, 127,            and 4START, 118
  22061.               141, 156                           and multitasker startup
  22062.              on networks, 160                     files, 155
  22063.              reduced, 140                        and SETLOCAL, 309
  22064.              types of, 127                       and swapping state, 311
  22065.           SWAPPING command, 311                  loading order, 164
  22066.           Swapping directive, 126, 144,       TYPE, 318
  22067.            160, 165
  22068.           SwapReopen directive, 141
  22069.           Switches, in commands, 169               -- U --
  22070.           System
  22071.              attribute, see File              UltraVision, 148
  22072.               attributes                      UMBEnvironment directive, 128,
  22073.              date, 204                         144, 165
  22074.              rebooting, 287                      and DESQview, 159
  22075.              tests, in IF and IFF, 248        UMBLoad directive, 128, 144,
  22076.              time, 314                         165
  22077.                                                  and DESQview, 159
  22078.                                               UMBs, see Memory
  22079.                -- T --                        UNALIAS, 105, 319
  22080.                                               Uninstalling 4DOS, 15
  22081.           Tab character, 94                   @UNIQUE variable function, 90
  22082.           Task switching software, see        UniqueSwapName directive, 127,
  22083.            Multitasking software               141, 156
  22084.           Technical Information, 348          UNSET, 78, 101, 320
  22085.              DESCRIPT.ION, 351                Up directive, 136
  22086.              detecting 4DOS, 348              Upgrades, 5
  22087.              installable commands, 350        Upper case, 132, 308
  22088.              INT 2E, 353                      @UPPER variable function, 90
  22089.              KEYSTACK, 349                    UpperCase directive, 132, 215,
  22090.           Technical support, 5, 7              308
  22091.           TEE, 312
  22092.           TEMP environment variable, 81,
  22093.            117, 160
  22094.           TEMP4DOS environment variable,
  22095.            81, 117, 160
  22096.           TEXT, 103, 313
  22097.           THEN, in IFF, 251
  22098.           TIME, 314
  22099.  
  22100.  
  22101.           ___________________________________________________________________
  22102.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  380
  22103.  
  22104.                                                                         Index
  22105.           ___________________________________________________________________
  22106.  
  22107.  
  22108.                -- V --                             -- X --
  22109.  
  22110.           Variable expansion, 95              XMS, see Memory
  22111.           Variable functions, 85, see         @XMS variable function, 90
  22112.            also names of individual           .XOR., in IF and IFF, 245, 250,
  22113.            functions                           251
  22114.              in aliases, 90, 180
  22115.              in batch files, 91, 101
  22116.           VER, 322                                 -- Y --
  22117.           VERIFY, 202, 323
  22118.           Version numbers, 82, 83, 322        Y, 326
  22119.           Vertical text display, 325
  22120.           VGA, 146, 148, 193, 250
  22121.           Video hardware, 52, 146, see
  22122.            also Screen
  22123.           _VIDEO internal variable, 84
  22124.           VOL, 324
  22125.           Volume label, see Disk drives
  22126.           Volume label attribute, see
  22127.            File attributes
  22128.           VSCRPUT, 103, 146, 325
  22129.  
  22130.  
  22131.                -- W --
  22132.  
  22133.           Warm reboot, 287
  22134.           Warning mark, see !
  22135.           Wildcards, 71
  22136.              and @SEARCH variable
  22137.               function, 89
  22138.              and filename completion, 60
  22139.              and renaming subdirectories,
  22140.               291
  22141.              extended, 72
  22142.                 and DEL, 149, 206
  22143.              in executable extensions, 77
  22144.              in include lists, 74
  22145.              in multiple filenames, 74
  22146.           _WIN internal variable, 84, 157
  22147.           Windows, see Microsoft Windows
  22148.           @WORD variable function, 90
  22149.           WordLeft directive, 136
  22150.           WordRight directive, 136
  22151.  
  22152.  
  22153.  
  22154.  
  22155.  
  22156.  
  22157.  
  22158.           ___________________________________________________________________
  22159.           Copyright 1993, JP Software Inc.      4DOS Reference Manual  /  381
  22160.